Skip to main content
Glama
Bitbucket Cloud MCP Server

Bitbucket Cloud MCP Server

by ttekun

Bitbucket Cloud MCP Server

License: MIT Node.js MCP

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?

Tool

Description

get_bb_pull_request

Retrieve pull request details (title, author, status, branches, etc.)

get_bb_diff

Get the full diff of a pull request

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: Atlassian 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

Variable

Required

Description

BITBUCKET_TOKEN

Yes

Bitbucket Cloud app password

BITBUCKET_WORKSPACE

No

Default workspace (can be overridden per request)

Tool Parameters

Both tools accept the same parameters:

Parameter

Type

Required

Description

workspace

string

Yes*

Bitbucket workspace (*falls back to BITBUCKET_WORKSPACE env var)

repo_slug

string

Yes

Repository slug

pull_request_id

number

Yes

Pull request ID

Development

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

License

MIT

Available Tools

2 tools
get_bb_diffB

Get pull request diff from Bitbucket Cloud

Inputs: workspace (required), repo_slug (required), pull_request_id (required).

get_bb_pull_requestA

Get pull request details from Bitbucket Cloud

Inputs: workspace (required), repo_slug (required), pull_request_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools, 'get_bb_diff' and 'get_bb_pull_request', have distinct purposes: one retrieves a pull request diff, the other retrieves pull request details. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    Both tools follow a consistent 'get_bb_{resource}' pattern, using snake_case and a clear prefix 'get_bb'. The naming is predictable and uniform.

    Tool Count3/5

    With only 2 tools, the server feels thin for a Bitbucket Cloud integration. While not extremely mismatched, it is below the typical 3-15 range and borders on insufficient.

    Completeness1/5

    The tool surface is severely incomplete for a Bitbucket Cloud server. It only provides read operations for pull requests, lacking CRUD operations for repos, branches, commits, and other essential resources.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to interact with Bitbucket Cloud repositories, allowing users to manage pull requests, comments, tasks, and branches through natural language commands.
      5,856 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to manage Bitbucket Cloud repositories, pull requests, pipelines, and code review tasks through natural language.
      74
      323 PyPI
      3
      MIT