Atlassian Bitbucket MCP Server

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via

Local serverstdioTypeScript

What is the Atlassian Bitbucket MCP Server?

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get

What the server does

A Node.js/TypeScript Model Context Protocol (MCP) server for Atlassian Bitbucket Cloud. Enables AI systems (e.g., LLMs like Claude or Cursor AI) to securely interact with your repositories, pull requests, workspaces, and code in real time.

Model Context Protocol (MCP) is an open standard for securely connecting AI systems to external tools and data sources. This server implements MCP for Bitbucket Cloud, enabling AI assistants to interact with your Bitbucket data programmatically.

  • Minimal Input, Maximum Output — Simple identifiers provide comprehensive details without requiring extra flags
  • Rich Code Visualization — Get detailed insights into code changes with file statistics, diff views, and smart context
  • Secure Local Authentication — Run locally with your credentials, never storing tokens on remote servers
  • Intuitive Markdown Responses — Well-structured, consistent Markdown formatting for all outputs
  • Full Bitbucket Integration — Access workspaces, repositories, pull requests, comments, code search, and more

Credentials and setup notes

  • Node.js (>=18.x): Download - Bitbucket Cloud Account

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
bb_ls_workspaces
bb_get_workspace
bb_ls_repos
bb_get_repo
bb_search
bb_ls_prs
bb_get_pr
bb_ls_pr_comments
bb_add_pr_comment
bb_add_pr
bb_add_branch
bb_clone_repo
bb_get_commit_history
bb_get_file
bb_diff_branches
bb_diff_commits
bb_list_branches

How to install the Atlassian Bitbucket MCP Server

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-bitbucket"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js (>=18.x): Download - Bitbucket Cloud Account

Example prompts to try

  • “Use Atlassian Bitbucket to bb ls workspaces.”
  • “Use Atlassian Bitbucket to bb get workspace.”
  • “Use Atlassian Bitbucket to bb ls repos.”

Frequently asked questions

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.