Bitbucket Cloud MCP Server

An MCP (Model Context Protocol) server that lets AI assistants read Bitbucket Cloud pull requests. Connect Claude, Copilot, or any MCP-compatible client to your Bitbucket Cloud workspace and review PRs through natural conversation.

What Can It Do?

Example prompts you can use with your AI assistant:

"Summarize pull request #42 in the my-app repo"

"Review the diff for PR #15 and suggest improvements"

"What's the status of open PRs in our project?"

Related MCP server: Bitbucket MCP Server

Quick Start

1. Install

git clone https://github.com/ttekun/bitbucket-cloud-mcp-server.git
cd bitbucket-cloud-mcp-server
npm install
npm run build

2. Get a Bitbucket App Password

1. Go to Bitbucket Cloud → Personal Settings → App passwords

2. Create a new app password with Repository: Read and Pull request: Read permissions

3. Configure Your MCP Client

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bitbucket-cloud": {
      "command": "node",
      "args": ["/absolute/path/to/bitbucket-cloud-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_TOKEN": "your-app-password",
        "BITBUCKET_WORKSPACE": "your-workspace"
      }
    }
  }
}

Add to your VS Code settings or .vscode/mcp.json:

{
  "mcpServers": {
    "bitbucket-cloud": {
      "command": "node",
      "args": ["/absolute/path/to/bitbucket-cloud-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_TOKEN": "your-app-password",
        "BITBUCKET_WORKSPACE": "your-workspace"
      }
    }
  }
}

Environment Variables

Tool Parameters

Both tools accept the same parameters:

Development

npm run dev        # Watch mode
npm test           # Run tests
npm run lint       # Lint
npm run inspector  # MCP Inspector (debug tool)

License

MIT