bitbucket-mcp is a feature-rich MCP server for Bitbucket Cloud and Server integration, offering a wide range of repository, pull request, and pipeline operations. It emphasizes safety by disabling delete tools by default and includes code scanning. Installation is straightforward with clear environment variable configuration, and it supports Cursor among other clients.
Strongest · Setup experience 14/20 Weakest · Reliability 4/20
Static review · not runListed 2026-08-07
Read the FMRS scoring method →Runtime：Node.js 18+
BITBUCKET_USERNAME
Your Bitbucket username, usually your email; required together with BITBUCKET_PASSWORD unless BITBUCKET_TOKEN is used.
BITBUCKET_PASSWORD
A Bitbucket app password created under Personal Settings > App Passwords with Repositories: Read, Pull requests: Read/Write, and Pipelines: Read permissions.
BITBUCKET_TOKEN
A Bitbucket access token that can be used instead of username/password authentication.
BITBUCKET_URL
Bitbucket API base URL, defaults to https://api.bitbucket.org/2.0; a web URL with the workspace also works and the workspace is auto-extracted.
BITBUCKET_WORKSPACE
Default workspace name; optional if the workspace is embedded in BITBUCKET_URL.
BITBUCKET_ENABLE_DANGEROUS
Set to true to enable dangerous tools such as deletions; disabled by default.
BITBUCKET_LOG_DISABLE
Set to true or 1 to disable file logging.
BITBUCKET_LOG_FILE
Absolute path to a specific log file.
BITBUCKET_LOG_DIR
Directory for storing logs; defaults to the OS-specific app log directory.
BITBUCKET_LOG_PER_CWD
Set to true to nest logs under a per-working-directory subfolder.
npx -y bitbucket-mcp@latest.npm install -g bitbucket-mcp and run bitbucket-mcp.{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": [
"-y",
"bitbucket-mcp@latest"
],
"env": {
"BITBUCKET_URL": "https://api.bitbucket.org/2.0",
"BITBUCKET_WORKSPACE": "your-workspace",
"BITBUCKET_USERNAME": "your-username",
"BITBUCKET_PASSWORD": "your-app-password"
}
}
}
}
Shown for Cursor. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
{
"servers": {
"bitbucket": {
"command": "npx",
"args": [
"-y",
"bitbucket-mcp@latest"
],
"env": {
"BITBUCKET_URL": "https://api.bitbucket.org/2.0",
"BITBUCKET_WORKSPACE": "your-workspace",
"BITBUCKET_USERNAME": "your-username",
"BITBUCKET_PASSWORD": "your-app-password"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
claude mcp add bitbucket -e BITBUCKET_URL=https://api.bitbucket.org/2.0 -e BITBUCKET_WORKSPACE=your-workspace -e BITBUCKET_USERNAME=your-username -e BITBUCKET_PASSWORD=your-app-password -- npx -y bitbucket-mcp@latest
Run it in a terminal; replace any <…> placeholders with your own values first.
After connecting, check the client's tool list for tools like listRepositories, getPullRequests, and runPipeline; calling listRepositories and getting back your workspace's repositories confirms authentication and connection work.
Once connected, you can ask your AI assistant things like:
No matching tools
Listed from the project's documentation, not tested by this site.
bitbucket-mcp is a Model Context Protocol (MCP) server that integrates AI assistants like Cursor with Bitbucket repositories, pull requests, and pipelines. It provides tools to list and retrieve repositories, manage pull requests (create, update, approve, merge, etc.), handle pull request comments, tasks, diffs, and pipelines. The server uses stdio transport and relies on environment variables for authentication.
Upstash's official server providing up-to-date third-party library docs for AI coding assistants
AI-powered NPM package analysis MCP server
An independent control layer that gives AI coding agents budgets, brakes, and receipts
GitHub's official MCP server for managing repos, issues, PRs, and workflows via natural language
Source revision d3594e2cfaae Data synced 2026-10-12 Read the FMRS scoring method