Enables management of Bitbucket Cloud repositories, pull requests, branches, commits, pipelines, issues, and webhooks. Supports workspace and project operations, code reviews, CI/CD pipeline triggers, and issue tracking.
Bitbucket MCP
A Model Context Protocol (MCP) server for Bitbucket Cloud. Enables AI assistants to manage repositories, pull requests, pipelines, and more.
Installation
Option 1: Using npx (Recommended)
No installation required. Run directly:
Option 2: Global Installation
Option 3: Local Development
MCP Client Configuration
Cursor IDE
Add to your Cursor MCP settings (~/.cursor/mcp.json on Windows: %USERPROFILE%\.cursor\mcp.json):
Using npx (Recommended):
Using local build:
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
Other MCP Clients
The server follows the MCP standard and works with any compatible client. Use the configuration pattern above, adjusting paths as needed for your platform.
Authentication
API Token (Recommended)
Go to Bitbucket API Tokens
Create a new token with the required permissions
Set the environment variables:
App Password
Go to Bitbucket App Passwords
Create a new app password with required permissions
Use
basicauth method with your username and app password
Environment Variables
Variable | Description | Required |
|
| Yes |
| Your Atlassian email | For api_token |
| API token | For api_token |
| Bitbucket username | For basic auth |
| App password | For basic auth |
| Default workspace | No |
|
| No |
Available Tools
Tool | Actions |
| list, get, list_projects, list_members |
| list, get, create, delete, fork, get_file, list_source |
| list, get, create, update, merge, approve, unapprove, decline, list_comments, add_comment, get_diff |
| list_branches, get_branch, create_branch, delete_branch, list_tags, get_tag, create_tag |
| list, get, get_diff, get_diffstat |
| list, get, trigger, trigger_custom, stop, list_steps, get_step, get_logs, get_config, set_enabled, list_variables, get_variable, create_variable, update_variable, delete_variable |
| list, get, create, update, delete, list_comments, add_comment, vote, unvote, watch, unwatch |
| list, get, create, update, delete, list_workspace, get_workspace, create_workspace, update_workspace, delete_workspace |
Output Formats
Control response verbosity with the format parameter:
Format | Description | Token Savings |
| Full JSON output | 0% |
| Compact TOON format | ~50% |
| Essential fields only | ~76% |
Example usage:
Examples
List repositories in a workspace
Create a pull request
Trigger a pipeline
Development
Requirements
Node.js >= 20.0.0
pnpm (for development)
License
MIT