Set up Bitbucket MCP in Claude Code

Interact with Atlassian Bitbucket workspaces, repositories, pull requests, and code search through the Bitbucket API.

Locate the config file

Claude Code reads MCP server configuration from the following file:

~/.claude.json

Create this file if it does not already exist.

Add the configuration

You can configure Bitbucket MCP using the CLI command or by editing the config file directly.

Option A: CLI command

bash

claude mcp add bitbucket-mcp -e ATLASSIAN_BITBUCKET_USERNAME=YOUR_ATLASSIAN_BITBUCKET_USERNAME -e ATLASSIAN_BITBUCKET_TOKEN=YOUR_ATLASSIAN_BITBUCKET_TOKEN -- npx -y @aashari/mcp-server-atlassian-bitbucket

Option B: Config file

json

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

Set up environment variables

Bitbucket MCP requires the following environment variables:

ATLASSIAN_BITBUCKET_USERNAMERequired

Bitbucket username or email

ATLASSIAN_BITBUCKET_TOKENRequired

Bitbucket app password or API token

Verify it works

Restart Claude Code. Bitbucket MCP should appear in your MCP server list with 10 tools available.

This server adds approximately 5,150 tokens to your context window for tool definitions.

Set up Bitbucket MCP in other editors

Cursor VS Code Windsurf Claude Desktop Continue

← Back to Bitbucket MCP