This server offers a fairly comprehensive toolset for the Bitbucket Server pull-request workflow — project/repository discovery, PR creation through merge, comments and batch reviews, code search, and file browsing — with a read-only mode and custom headers for enterprise network setups; credentials must be protected and the irreversibility of write actions outside read-only mode should be kept in mind.
Strongest · Documentation 16/20 Weakest · Reliability 7/20
Static review · not runListed 2026-08-26
Read the FMRS scoring method →Runtime：Node.js 16+
BITBUCKET_URL
Required: base URL of your Bitbucket Server instance.
BITBUCKET_TOKEN
Personal access token generated in Bitbucket Server; alternative to username/password auth.
BITBUCKET_PASSWORD
Bitbucket password, used with BITBUCKET_USERNAME.
BITBUCKET_USERNAME
Bitbucket username, used with BITBUCKET_PASSWORD for basic authentication.
BITBUCKET_DEFAULT_PROJECT
Optional default project key used when a tool call does not specify a project.
BITBUCKET_DIFF_MAX_LINES_PER_FILE
Optional default maximum lines shown per file in diffs to keep output manageable.
BITBUCKET_LOG_PATH
Optional custom log file path; defaults to ~/.bitbucket-server-mcp/bitbucket.log.
BITBUCKET_READ_ONLY
Set to true to enable read-only mode that disables all write operations.
BITBUCKET_CUSTOM_HEADERS
Optional comma-separated custom HTTP headers, useful for Zero Trust tokens or proxy headers.
npx -y @smithery/cli install @garc33/bitbucket-server-mcp-server --client claude), or install manually with npm install followed by npm run build.command to node and args to the path of the built build/index.js.BITBUCKET_URL, plus either BITBUCKET_TOKEN or BITBUCKET_USERNAME/BITBUCKET_PASSWORD for authentication; optionally set BITBUCKET_DEFAULT_PROJECT, BITBUCKET_READ_ONLY, BITBUCKET_CUSTOM_HEADERS, BITBUCKET_LOG_PATH, and BITBUCKET_DIFF_MAX_LINES_PER_FILE.{"mcpServers":{"bitbucket":{"command":"node","args":["/path/to/bitbucket-server/build/index.js"],"env":{"BITBUCKET_URL":"https://your-bitbucket-server.com","BITBUCKET_TOKEN":"your-access-token","BITBUCKET_DEFAULT_PROJECT":"your-default-project"}}}}
Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
{
"servers": {
"bitbucket": {
"command": "node",
"args": [
"/path/to/bitbucket-server/build/index.js"
],
"env": {
"BITBUCKET_URL": "https://your-bitbucket-server.com",
"BITBUCKET_TOKEN": "your-access-token",
"BITBUCKET_DEFAULT_PROJECT": "your-default-project"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
claude mcp add bitbucket -e BITBUCKET_URL=https://your-bitbucket-server.com -e BITBUCKET_TOKEN=your-access-token -e BITBUCKET_DEFAULT_PROJECT=your-default-project -- node /path/to/bitbucket-server/build/index.js
Run it in a terminal; replace any <…> placeholders with your own values first.
After building the project, tools such as list_projects and get_pull_request should appear in your client's tool list; run list_projects — if it returns projects from your Bitbucket instance, the connection works.
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 Server MCP is a Node.js MCP server that exposes the Bitbucket Server REST API for project and repository discovery, full pull-request lifecycle management (create, update, approve, merge, decline), code search, file reading, branch and commit history browsing, comment management, and CI/CD code insights (e.g. SonarQube). It supports configuring a default project, a read-only mode, and custom HTTP headers (useful for Zero Trust tokens or proxies) via environment variables.
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 7c8a414cadfc Data synced 2026-10-19 Read the FMRS scoring method