MCP MCP Server

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

Local serverstdioGo

What is the MCP MCP server?

Most developer tooling work still happens through a UI a human drives. MCP MCP server moves it into the conversation instead. Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through.

The short version

Transform how you work with Bitbucket by connecting Claude, Cursor AI, and other AI assistants directly to your repositories, pull requests, and code. Get instant insights, automate code reviews, and streamline your development workflow.

The tools it exposes

The server publishes 6 tools. What each one is for:

  • bb_get — GET any Bitbucket API endpoint (read data)
  • bb_post — POST to any endpoint (create resources)
  • bb_put — PUT to any endpoint (replace resources)
  • bb_patch — PATCH any endpoint (partial updates)
  • bb_delete — DELETE any endpoint (remove resources)
  • bb_clone — Clone a repository locally

What it needs from you

Configuration is passed through the environment: ATLASSIAN_USER_EMAIL, ATLASSIAN_API_TOKEN, ATLASSIAN_BITBUCKET_USERNAME, ATLASSIAN_BITBUCKET_APP_PASSWORD, BITBUCKET_DEFAULT_WORKSPACE, DEBUG. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • Node.js 18.0.0 or higher - Bitbucket Cloud account (not Bitbucket Server/Data Center) - Authentication credentials: Scoped API Token (recommended) or App Password (legacy)

Getting it running

@aashari/mcp-server-atlassian-bitbucket on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. MCP's toolset — bb_get, bb_post, bb_put and 3 more — is a fair guide to whether it matches your workflow. It is maintained by GitHub Actions; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
bb_getGET any Bitbucket API endpoint (read data)
bb_postPOST to any endpoint (create resources)
bb_putPUT to any endpoint (replace resources)
bb_patchPATCH any endpoint (partial updates)
bb_deleteDELETE any endpoint (remove resources)
bb_cloneClone a repository locally

How to install the MCP MCP server

{
  "mcpServers": {
    "atlassian-bitbucket-1": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your-value",
        "ATLASSIAN_API_TOKEN": "your-value",
        "ATLASSIAN_BITBUCKET_USERNAME": "your-value",
        "ATLASSIAN_BITBUCKET_APP_PASSWORD": "your-value",
        "BITBUCKET_DEFAULT_WORKSPACE": "your-value",
        "DEBUG": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js 18.0.0 or higher - Bitbucket Cloud account (not Bitbucket Server/Data Center) - Authentication credentials: Scoped API Token (recommended) or App Password (legacy)
VariableDescriptionRequired
ATLASSIAN_USER_EMAILConfiguration value read at startup.Optional
ATLASSIAN_API_TOKENCredential the server authenticates with.Yes
ATLASSIAN_BITBUCKET_USERNAMEConfiguration value read at startup.Optional
ATLASSIAN_BITBUCKET_APP_PASSWORDConfiguration value read at startup.Optional
BITBUCKET_DEFAULT_WORKSPACEConfiguration value read at startup.Optional
DEBUGConfiguration value read at startup.Optional

Example prompts to try

  • Use MCP to bb get.
  • Use MCP to bb post.
  • Use MCP to bb put.

Frequently asked questions

It connects MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (bb_get, bb_post, bb_put, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP directly.