How to add Atlassian Bitbucket MCP Server to Claude Desktop

Connect AI assistants to Bitbucket Cloud repositories, pull requests, and code via 6 generic API tools. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 156★ · stdio · apikey

Claude Desktop config for Atlassian Bitbucket MCP Server

npm install -g @aashari/mcp-server-atlassian-bitbucket

{
  "mcpServers": {
    "atlassian-bitbucket-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-bitbucket"
      ],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Atlassian Bitbucket MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Atlassian Bitbucket MCP Server's tools appear under the 🔌 tools menu.

Before you start

Node.js 18.0.0 or higher
Bitbucket Cloud account (not Bitbucket Server/Data Center)
Scoped API Token (recommended) or legacy App Password with appropriate scopes/permissions

What Atlassian Bitbucket MCP Server can do in Claude Desktop

bb_get

GET any Bitbucket API endpoint to read data. Parameters: path, queryParams?, jq?, outputFormat?.

bb_post

POST to any endpoint to create resources (e.g., create a PR or add a comment). Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_put

PUT to any endpoint to replace resources. Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_patch

PATCH any endpoint for partial updates (e.g., update a PR title). Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_delete

DELETE any endpoint to remove resources (e.g., delete a branch or remove PR approval). Parameters: path, queryParams?, jq?, outputFormat?.

bb_clone

Clone a repository locally. Parameters: workspaceSlug? (uses default if omitted), repoSlug, targetPath (absolute path to parent directory).

Security

Runs entirely on your local machine and uses your own Bitbucket credentials; never sends data to third parties. Requires a Bitbucket Cloud Scoped API Token (recommended) or legacy App Password — App Passwords are being deprecated and removed by June 2026, so prefer scoped API tokens. Grant only the scopes you need: 'repository' and 'workspace' for read-only, plus 'pullrequest' for PR management. Bitbucket Cloud only (not Server/Data Center).

Atlassian Bitbucket MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Atlassian Bitbucket MCP Server config there under the "mcpServers" key and restart the client.

Is Atlassian Bitbucket MCP Server safe to use with Claude Desktop?

What permissions or scopes do I need?

For Scoped API Tokens (recommended): 'repository' and 'workspace' scopes, plus 'pullrequest' for PR management. For legacy App Passwords: Workspaces Read, Repositories Read, Pull Requests Read for read-only; add Write permissions for repositories and pull requests for full functionality.

Does it work with private repositories?

Yes. It works with both public and private repositories, as long as your credentials have the appropriate permissions.

Which AI assistants are supported?

Any MCP-compatible client, including Claude Desktop (official support), Cursor AI, Continue.dev, and Cline.

View repo Full Atlassian Bitbucket MCP Server page