MCP Server — aashari

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 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

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.

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.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Recorded tools

  • 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

More MCP options

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

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_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 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

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.