Bitbucket Cloud MCP Server
Provides tools for retrieving pull request details and diffs from Bitbucket Cloud.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bitbucket Cloud MCP Server Summarize pull request #42 in the my-app repo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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?
Tool | Description |
| Retrieve pull request details (title, author, status, branches, etc.) |
| 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 build2. Get a Bitbucket App Password
Go to Bitbucket Cloud → Personal Settings → App passwords
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 |
| Yes | Bitbucket Cloud app password |
| No | Default workspace (can be overridden per request) |
Tool Parameters
Both tools accept the same parameters:
Parameter | Type | Required | Description |
| string | Yes* | Bitbucket workspace (*falls back to |
| string | Yes | Repository slug |
| 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
Available Tools
2 toolsget_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
Scored across 2 tools
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.
Both tools follow a consistent 'get_bb_{resource}' pattern, using snake_case and a clear prefix 'get_bb'. The naming is predictable and uniform.
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.
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
Related MCP Connectors
Plan Salesforce deploys, open pull requests and trigger pipelines from your AI client.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Code intelligence for LLMs. Analyze, search, and retrieve code from any public git repository.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Bitbucket Cloud repositories, allowing users to manage pull requests, comments, tasks, and branches through natural language commands.5,856 npm1MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to interact with Bitbucket Cloud and self-hosted instances for pull request reviews, code search, repository operations, and managing PR comments and approvals.19GPL 3.0
- AlicenseAqualityBmaintenanceEnables AI assistants to manage Bitbucket Cloud repositories, pull requests, pipelines, and code review tasks through natural language.74323 PyPI3MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Bitbucket Cloud and Server APIs, including listing and retrieving repositories and fetching, creating, and viewing pull requests.5,856 npmMIT