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.
Bitbucket MCP Server
@MatanYemini
Basic information
About Bitbucket MCP Server
Bitbucket MCP - A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs
Bitbucket MCP Server config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"bitbucket-mcp": {
"command": "npx",
"args": [
"-y",
"bitbucket-mcp@latest"
]
}
}
}Bitbucket MCP Server tools
Tool list not available yet
This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.
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
Frequently asked questions
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`.
More Version Control MCP servers
GitLab
modelcontextprotocolModel Context Protocol Servers
88.1K
MCP Linear
tacticlaunchMCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.
141
MCP Git Ingest
adhikaspA Model Context Protocol (MCP) server that helps read GitHub repository structure and important files.
316
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.
45
GitHub Stars MCP Server
ccbikaiA Cloudflare-powered MCP (Model Context Protocol) Server that allows you to search and query your GitHub starred repositories using natural language.
111
Comments