Bitbucket
A Model Context Protocol server that enables AI assistants to interact with Bitbucket repositories, pull requests, and other resources through Bitbucket Cloud and Server APIs.
What is Bitbucket?
Bitbucket is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that enables ai assistants to interact with bitbucket repositories, pull requests, and other resources through bitbucket cloud and server apis.
A Model Context Protocol server that enables AI assistants to interact with Bitbucket repositories, pull requests, and other resources through Bitbucket Cloud and Server APIs.
This server falls under the Version Control category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that enables AI assistants t
Use Cases
Maintainer
Works with
Installation
NPM
npx -y bitbucket-mcpManual Installation
npx -y bitbucket-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bitbucket
Bitbucket MCP is a Model Context Protocol server that gives AI assistants structured access to Bitbucket Cloud and Bitbucket Server repositories, pull requests, and pipeline data through the official Bitbucket REST API. It supports both username/app-password authentication and access token authentication, and exposes safe read and write operations — with DELETE operations disabled by default to prevent accidental data loss. Development teams that use Bitbucket for version control can use this server to query repository status, review pull requests, and automate code review workflows through their AI assistant.
Prerequisites
- Node.js installed (LTS recommended)
- A Bitbucket Cloud account or Bitbucket Server instance
- A Bitbucket App Password with Repositories: Read and Pull requests: Read/Write permissions (created at Bitbucket > Personal Settings > App Passwords)
- An MCP-compatible client such as Claude Desktop or Cursor
Create a Bitbucket App Password
Log in to Bitbucket, navigate to Personal Settings > App Passwords, and create a new app password. Enable at minimum: Repositories (Read), Pull requests (Read, Write), and Pipelines (Read). Copy the generated password immediately.
Add the server to your MCP client configuration
Add the bitbucket-mcp server block to your claude_desktop_config.json or equivalent. The BITBUCKET_USERNAME for Bitbucket Cloud is typically your email address.
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "bitbucket-mcp@latest"],
"env": {
"BITBUCKET_URL": "https://api.bitbucket.org/2.0",
"BITBUCKET_WORKSPACE": "your-workspace",
"BITBUCKET_USERNAME": "[email protected]",
"BITBUCKET_PASSWORD": "your-app-password"
}
}
}
}Alternatively, use an access token
If you prefer token-based authentication instead of username/password, set the BITBUCKET_TOKEN environment variable instead.
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "bitbucket-mcp@latest"],
"env": {
"BITBUCKET_URL": "https://api.bitbucket.org/2.0",
"BITBUCKET_WORKSPACE": "your-workspace",
"BITBUCKET_TOKEN": "your-access-token"
}
}
}
}Restart your MCP client
Save the configuration and restart Claude Desktop or Cursor. The Bitbucket MCP server will start automatically.
Start querying your Bitbucket repositories
Ask the AI to list repositories, get pull request details, or review open PRs in your Bitbucket workspace.
Bitbucket Examples
Client configuration
Claude Desktop configuration using a Bitbucket App Password.
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "bitbucket-mcp@latest"],
"env": {
"BITBUCKET_URL": "https://api.bitbucket.org/2.0",
"BITBUCKET_WORKSPACE": "myteam",
"BITBUCKET_USERNAME": "[email protected]",
"BITBUCKET_PASSWORD": "ATBBxxxxxxxxxxxx"
}
}
}
}Prompts to try
Example queries for interacting with your Bitbucket workspace.
- "List all open pull requests in the backend-api repository"
- "Show me the details of pull request #42 in the frontend repo"
- "What repositories are available in my Bitbucket workspace?"
- "Get the diff for the latest PR in the mobile-app repository"
- "Show pipeline status for the main branch of the data-service repo"Troubleshooting Bitbucket
401 Unauthorized errors on every request
Ensure you are using a Bitbucket App Password (not your account password). For Bitbucket Cloud, BITBUCKET_USERNAME should be your email address, not your display name. Test credentials directly: `curl -u '[email protected]:app-password' 'https://api.bitbucket.org/2.0/repositories/your-workspace'`
Workspace not found or empty repository list
Verify the BITBUCKET_WORKSPACE value matches the exact workspace slug shown in your Bitbucket URL (e.g., bitbucket.org/your-workspace). The slug is case-sensitive.
Atlassian API key does not work as BITBUCKET_TOKEN
Atlassian API keys should be placed in BITBUCKET_PASSWORD alongside your email in BITBUCKET_USERNAME — not in the BITBUCKET_TOKEN field. See the Atlassian API token documentation for details.
Frequently Asked Questions about Bitbucket
What is Bitbucket?
Bitbucket is a Model Context Protocol (MCP) server that model context protocol server that enables ai assistants to interact with bitbucket repositories, pull requests, and other resources through bitbucket cloud and server apis. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bitbucket?
Install via npm with the command: npx -y bitbucket-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Bitbucket?
Bitbucket works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bitbucket free to use?
Yes, Bitbucket is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Bitbucket Alternatives — Similar Version Control Servers
Looking for alternatives to Bitbucket? Here are other popular version control servers you can use with Claude, Cursor, and VS Code.
Ruiyu MA
★ 30.1kConnect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
GitMCP
★ 8.1kTransforms any GitHub repository or GitHub Pages site into a documentation hub for AI assistants using the Model Context Protocol. It allows AI tools to access real-time code and documentation to prevent hallucinations and provide accurate API usage
GitHub Codemunch
★ 1.8kA token-efficient MCP server for exploring GitHub repositories using tree-sitter AST parsing to extract symbol signatures and summaries. It enables users to search and retrieve specific code components while significantly reducing token consumption c
Azure DevOps MCP Server
★ 1.7kThis server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standard
GitHub Official
★ 1.2kOfficial GitHub integration with comprehensive API coverage
Azure DevOps
★ 367Enables interaction with Azure DevOps through Cursor chat, providing tools to manage builds, pipelines, work items, sprints, and board operations. Supports secure authentication via Personal Access Tokens and allows natural language-driven DevOps tas
Browse More Version Control MCP Servers
Explore all version control servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bitbucket in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bitbucket?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.