BitBucket-MCP-To-Review-PRs

A read-only MCP (Model Context Protocol) server for the Bitbucket Cloud REST API v2.0. Enables AI assistants (Kiro, VS Code, Claude Desktop, etc.) to browse workspaces, repositories, and review pull requests — all without modifying anything in Bitbucket.

Features

• List workspaces and repositories

• List, view, and review pull requests

• Get PR diffs, diffstats, comments, and commits

• Parse Bitbucket PR URLs for one-shot review context

• View file contents at any commit

• Automatic pagination and rate limit handling

• Strictly read-only (GET requests only)

Related MCP server: mcp-bitbucket-dc

Prerequisites

• Bun runtime

• A Bitbucket Cloud account with an App Password

App Password Scopes

Create an App Password with these read permissions:

• Account (Read)

• Workspace membership (Read)

• Repositories (Read)

• Pull requests (Read)

Setup

git clone https://github.com/arslanismail/BitBucket-MCP-To-Review-PRs.git
cd BitBucket-MCP-To-Review-PRs
bun install

MCP Client Configuration

Add this to your MCP client config:

Kiro: .kiro/settings/mcp.json VS Code (Copilot): .vscode/mcp.json Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "bun",
      "args": ["run", "src/index.ts"],
      "cwd": "/absolute/path/to/BitBucket-MCP-To-Review-PRs",
      "env": {
        "BITBUCKET_USERNAME": "<your-atlassian-email>",
        "BITBUCKET_TOKEN": "<your-app-password>"
      }
    }
  }
}

Important: Use your Atlassian account email as the username, not your Bitbucket username.

Available Tools

Example Usage

Once connected, ask your AI assistant:

• "List my Bitbucket workspaces"

• "Show me open PRs in avizia/one"

• "Review this PR: https://bitbucket.org/myworkspace/myrepo/pull-requests/123"

Project Structure

src/
├── index.ts              # Entry point, env validation, tool registration
├── bitbucket-client.ts   # HTTP client (GET-only, auth, pagination, rate limiting)
├── types.ts              # Bitbucket API response interfaces
└── tools/                # Individual tool implementations
    ├── list-workspaces.ts
    ├── list-repositories.ts
    ├── list-pull-requests.ts
    ├── get-pull-request.ts
    ├── get-pull-request-diff.ts
    ├── get-pull-request-diffstat.ts
    ├── get-pull-request-comments.ts
    ├── get-pull-request-commits.ts
    ├── get-pr-from-link.ts
    └── get-file-contents.ts

License

MIT