Bitbucket MCP

Bitbucket MCP Server

An MCP server that connects Claude Desktop and Claude Code to Bitbucket Cloud, enabling AI-assisted bug triage, impact analysis from live repository data.

Tools

| Tool | Description | |---|---| | search_by_jira_id | Find PRs (by title/branch) and commits (by message) linked to a Jira issue key. Searches one repo or all repos in the workspace. | | search_by_pr_title | Search PRs by keyword — returns details, description, comments, and changed files in one response | | get_changed_files | List modified files with line add/remove counts for a PR number or commit hash | | get_diff | Return the full unified diff for a PR or commit, truncated at a line boundary if over 50,000 characters | | get_file_content | Return the full content of a file at a given branch or commit ref | | get_commit_history_for_file | Show commit history for a file — frequency, authors, and dates | | get_related_prs | Find other PRs that touched the same files as a given PR or commit | | list_repos | List all repositories in the configured workspace |

Authentication

Bitbucket Cloud uses Basic Auth with a Bitbucket API Token

1. Go to Bitbucket -> Account Settings -> Security -> API Tokens
2. Create a Token with Scope

Quick setup (Windows)

Run the setup script — it installs dependencies, builds, prompts for credentials, and registers the server in both Claude Desktop and Claude Code:

powershell -ExecutionPolicy Bypass -File setup.ps1

Credentials are written to .env.local (git-ignored). The MCP config entry stays secret-free.

Manual setup

1. Install and build

npm install
npm run build

2. Create .env.local

BITBUCKET_WORKSPACE=https://bitbucket.org/your-workspace/workspace/overview/
BITBUCKET_EMAIL=you@example.com
BITBUCKET_API_TOKEN=your_app_password_here

3. Register in Claude Desktop

Open %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) and add:

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["C:/path/to/bitbucket-mcp-server/dist/index.js"]
    }
  }
}

Restart Claude Desktop to load the tools.

4. Register in Claude Code

claude mcp add bitbucket node "C:/path/to/bitbucket-mcp-server/dist/index.js" --scope user

Environment variables

| Variable | Required | Description | |---|---|---| | BITBUCKET_WORKSPACE | Yes | Full workspace URL or slug (e.g. my-workspace) | | BITBUCKET_EMAIL | Yes | Your Atlassian account email | | BITBUCKET_API_TOKEN | Yes | Bitbucket App Password (from account → App passwords) |

Example prompts

"Show me all PRs and commits related to PROJ-123"
"Search PRs mentioning login timeout in repo my-service"
"What files were changed in PR 42 in repo my-service?"
"Get the diff for commit a1b2c3d4 in repo my-service"
"Show me the content of src/auth.ts on the main branch"
"Who has been changing src/payment/processor.ts and how often?"
"Find other PRs that touched the same files as PR 42"
"List all repos in the workspace"