Log inSubmit server
Bitbucket MCP Server logo

Bitbucket MCP Server

Bitbucket Cloud MCP server for pull requests, diffs, comments, and AI-assisted code review.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Bitbucket MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "bitbucket-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@droplinkperformance/bitbucket-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT": "YOUR_VALUE_HERE",
        "BITBUCKET_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "BITBUCKET_EMAIL": "YOUR_VALUE_HERE",
        "BITBUCKET_USERNAME": "YOUR_VALUE_HERE",
        "BITBUCKET_CLIENT_ID": "YOUR_VALUE_HERE",
        "BITBUCKET_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "BITBUCKET_DEFAULT_WORKSPACE": "YOUR_VALUE_HERE",
        "LLM_PROVIDER": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @droplinkperformance/bitbucket-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 6d ago.

Overview

The bitbucket-mcp-server MCP server connects AI clients to Bitbucket Cloud for pull-request inspection, creation, updates, comments, and AI review. It exposes tools through stdio or Streamable HTTP and uses workspace and repository context for each operation. Reach for it when an agent needs to review changes, retrieve diffs and files, or manage pull-request discussions in Bitbucket. Authentication supports bearer tokens, API tokens, legacy app passwords, and OAuth 2.0.

Use cases

  • Review Bitbucket pull requests with an AI agent
  • Inspect pull-request diffs and changed files
  • Create and update Bitbucket pull requests
  • Add inline comments to pull requests
  • List pull requests by state or query

Key features

  • Bitbucket Cloud pull-request operations
  • AI pull-request analysis with ReviewResult output
  • Stdio and Streamable HTTP transports
  • OAuth 2.0, bearer token, API token, and app-password authentication
  • Automatic pagination, retries, caching, and rate-limit handling
  • Pluggable LLM, cache, and token-store providers

Tools10

What Bitbucket MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~113 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 42d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4h ago via OSV.dev · @droplinkperformance/bitbucket-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads584Package downloads in the last 30 days.
Last commit16d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed10Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Bitbucket MCP Server works

What bitbucket-mcp-server MCP server does

The bitbucket-mcp-server MCP server provides MCP tools for Bitbucket Cloud pull-request workflows. It can identify the authenticated user, list pull requests by state or query, retrieve a pull request, create or update an open pull request, and fetch its diff, changed files, line statistics, and comments.

Agents can also add regular or inline comments with comment_pull_request. The analyze_pull_request tool runs an AI review and returns a standard ReviewResult. The project describes AI review as its primary purpose rather than general CRUD access to Bitbucket.

Every tool accepts a workspace value, with repository used where relevant. A default workspace can be configured so callers do not need to provide it on every request.

How it works

The bitbucket-mcp-server MCP server separates MCP adapters from application use cases and Bitbucket-specific repository code. Tool discovery is handled by a ToolRegistry, while the Bitbucket client manages authentication injection, pagination, retries, backoff, rate-limit handling, caching, and secret masking.

The review workflow uses a CodeReviewAgent. Large pull requests can be split into chunks according to file-count and diff-line thresholds before being sent to the configured language-model provider. Supported provider choices are OpenAI, Anthropic, Gemini, and Bedrock. Cache and token storage can use memory, files, or Redis, depending on configuration.

Two transports are available: stdio for local MCP clients and Streamable HTTP for remote or production deployments. The HTTP mode exposes /health and /mcp endpoints.

Setup and configuration

Node.js 23 or newer is required. The published package can be started with:

Terminal
npx -y @droplinkperformance/bitbucket-mcp-server

For a source checkout, install dependencies and build with npm install followed by npm run build. Configuration can be loaded from an environment file using Node's --env-file option.

Authentication depends on the credential type. Bearer access tokens use BITBUCKET_ACCESS_TOKEN; API tokens also require BITBUCKET_EMAIL; legacy app passwords use BITBUCKET_USERNAME. OAuth requires BITBUCKET_CLIENT_ID and BITBUCKET_CLIENT_SECRET, with an optional refresh-token seed for headless startup. MCP_TRANSPORT selects stdio or HTTP, while HTTP_HOST and HTTP_PORT control the HTTP listener.

Tools and capabilities

  • Identify the authenticated Bitbucket user.
  • List, retrieve, create, and update pull requests.
  • Retrieve unified diffs and changed-file statistics.
  • Read pull-request comments and add inline or general comments.
  • Analyze pull requests with a configured LLM provider.
  • Use memory or Redis for caching, and file, memory, or Redis for token storage.

Limitations and notes

The project is marked Phase 1. Bitbucket Cloud is the implemented SCM target; the provider-agnostic interfaces are intended to support other providers later, but those targets are not established here. Redis and Bedrock dependencies are optional and loaded only when their providers are selected. App-password authentication is described as legacy and supported until June 2026.

AI review requires a configured LLM provider and its corresponding credentials. OAuth token persistence depends on the selected token store. HTTP deployment requires the caller to connect to the configured host and port, while local clients such as Cursor and Claude Desktop can use the stdio transport.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Bitbucket MCP Server

bitbucket-mcp-server is an MCP server that connects AI clients to Bitbucket Cloud. Its main tools list, retrieve, create, update, and comment on pull requests, fetch diffs and changed files, identify the current user, and run AI-powered pull-request analysis through a standard ReviewResult.

Install it with `npx -y @droplinkperformance/bitbucket-mcp-server`. From source, run `npm install` and `npm run build`; Node.js 23 or newer is required.

Use `BITBUCKET_ACCESS_TOKEN` for bearer authentication, or add `BITBUCKET_EMAIL` for an ATATT API token. OAuth requires `BITBUCKET_CLIENT_ID` and `BITBUCKET_CLIENT_SECRET`; legacy app passwords use `BITBUCKET_USERNAME`.

Yes, bitbucket-mcp-server supports Cursor through its stdio transport.

Related MCP servers

All in Version Control All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBitbucket MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/bitbucket-mcp-server?style=directory)](https://allmcps.com/mcp/bitbucket-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/bitbucket-mcp-server"><img src="https://allmcps.com/api/badge/bitbucket-mcp-server?style=directory" alt="Bitbucket MCP Server on AllMCPs" /></a>