BitBucket-MCP-To-Review-PRs

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)

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

| Tool | Description | Input | |------|-------------|-------| | list_workspaces | List all accessible workspaces | — | | list_repositories | List repos in a workspace | workspace | | list_pull_requests | List PRs (defaults to OPEN) | workspace, repo_slug, state? | | get_pull_request | Get full PR details | workspace, repo_slug, pull_request_id | | get_pull_request_diff | Get unified diff | workspace, repo_slug, pull_request_id | | get_pull_request_diffstat | Get files changed summary | workspace, repo_slug, pull_request_id | | get_pull_request_comments | Get all PR comments | workspace, repo_slug, pull_request_id | | get_pull_request_commits | Get commits in a PR | workspace, repo_slug, pull_request_id | | get_pr_from_link | Parse PR URL, return details + diff + diffstat | url | | get_file_contents | Get file at a specific commit | workspace, repo_slug, commit, path |

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