Bitbucket MCP
@MatanYemini
About Bitbucket MCP
Bitbucket MCP - A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"bitbucket-mcp": {
"command": "npx",
"args": [
"-y",
"bitbucket-mcp@latest"
]
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is Bitbucket MCP?
A Model Context Protocol (MCP) server that integrates AI assistants like Cursor with Bitbucket Cloud and Server APIs, enabling interaction with repositories and pull requests.
How to use Bitbucket MCP?
Run via npx -y bitbucket-mcp@latest or install globally/project‑wise with npm, then set environment variables (BITBUCKET_URL, BITBUCKET_USERNAME, BITBUCKET_PASSWORD or BITBUCKET_TOKEN, BITBUCKET_WORKSPACE). Configure as an MCP tool in Cursor using the provided JSON snippet.
Key features of Bitbucket MCP
- No destructive operations by default (safe design)
- List, get, create, update, and merge pull requests
- List and get repository details
- Pagination with automatic following of next links (up to 1,000 items)
- Automatic workspace extraction from URL (legacy mode)
- CodeQL security scanning on every code change
Use cases of Bitbucket MCP
- List all repositories in a Bitbucket workspace from an AI chat
- Fetch open pull requests for a repository to assist code review
- Create a pull request with title, description, and reviewer list
- Approve, merge, or decline a pull request without leaving the assistant
- View pull request activity logs to understand recent changes
FAQ from Bitbucket MCP
What authentication methods are supported?
Either a Bitbucket app password (BITBUCKET_USERNAME + BITBUCKET_PASSWORD) or an access token (BITBUCKET_TOKEN) is required. App passwords need at least Repositories: Read permission.
How do I resolve 401 authentication errors?
Verify you are using an app password (not your regular password) and that it has the necessary permissions. Try the direct API URL https://api.bitbucket.org/2.0 and test credentials with curl.
What is the BITBUCKET_ENABLE_DANGEROUS flag?
When set to true, it enables destructive operations (e.g., deletions). By default, no DELETE operations are exposed to ensure safety.
Does the server support pagination for large result sets?
Yes. Listing tools accept pagelen (default 10, max 100), page, and all. When all=true, the server automatically follows Bitbucket next links up to 1,000 entries.
Where can I find the server logs?
Logging can be disabled with BITBUCKET_LOG_DISABLE. Log files are stored in the OS‑specific app log directory, configurable via BITBUCKET_LOG_DIR and BITBUCKET_LOG_FILE.
Frequently asked questions
What authentication methods are supported?
Either a Bitbucket app password (`BITBUCKET_USERNAME` + `BITBUCKET_PASSWORD`) or an access token (`BITBUCKET_TOKEN`) is required. App passwords need at least Repositories: Read permission.
How do I resolve 401 authentication errors?
Verify you are using an app password (not your regular password) and that it has the necessary permissions. Try the direct API URL `https://api.bitbucket.org/2.0` and test credentials with `curl`.
What is the `BITBUCKET_ENABLE_DANGEROUS` flag?
When set to `true`, it enables destructive operations (e.g., deletions). By default, no DELETE operations are exposed to ensure safety.
Does the server support pagination for large result sets?
Yes. Listing tools accept `pagelen` (default 10, max 100), `page`, and `all`. When `all=true`, the server automatically follows Bitbucket `next` links up to 1,000 entries.
Where can I find the server logs?
Logging can be disabled with `BITBUCKET_LOG_DISABLE`. Log files are stored in the OS‑specific app log directory, configurable via `BITBUCKET_LOG_DIR` and `BITBUCKET_LOG_FILE`.
Basic information
More Version Control MCP servers
Git
modelcontextprotocolModel Context Protocol Servers
GitLab
modelcontextprotocolModel Context Protocol Servers
Jira MCP
nguyenvanduocitA Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations including issue management, sprint planning, and workflow tra
Linear MCP Server
clinea private MCP server for accessing Linear
Kin
Troy Fortin, Jr. (Firelock, LLC)The system of record for AI-written software. A persistent graph of entities, relationships, changes, and provenance, so humans and AI agents see what a change touches before it merges. Beside Git today.
Comments