Bitbucket MCP Server

by b1ffio.github.b1ff/atlassian-dc-mcp-bitbucketv0.35.0

MCP server for Atlassian Bitbucket Data Center - interact with repositories and code

101Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active18d ago

Install Bitbucket MCP server

claude mcp add bitbucket-b1ff -e BITBUCKET_API_TOKEN='<bitbucket-api-token>' -- npx -y @atlassian-dc-mcp/bitbucket

{
  "mcpServers": {
    "bitbucket-b1ff": {
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/bitbucket"
      ],
      "env": {
        "BITBUCKET_API_TOKEN": "<bitbucket-api-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "bitbucket-b1ff": {
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/bitbucket"
      ],
      "env": {
        "BITBUCKET_API_TOKEN": "<bitbucket-api-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "bitbucket-b1ff": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/bitbucket"
      ],
      "env": {
        "BITBUCKET_API_TOKEN": "<bitbucket-api-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "bitbucket-b1ff": {
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/bitbucket"
      ],
      "env": {
        "BITBUCKET_API_TOKEN": "<bitbucket-api-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ATLASSIAN_DC_MCP_CONFIG_FILE	—	—	Absolute path to a shared dotenv-style config file. When set, values are read from this file before direct environment variable overrides are applied.
BITBUCKET_HOST	—	—	Bitbucket host domain (e.g. your-instance.atlassian.net). Required unless provided through ATLASSIAN_DC_MCP_CONFIG_FILE or BITBUCKET_API_BASE_PATH.
BITBUCKET_API_BASE_PATH	—	—	Bitbucket API base path (alternative to BITBUCKET_HOST). Required unless provided through ATLASSIAN_DC_MCP_CONFIG_FILE or BITBUCKET_HOST.
BITBUCKET_API_TOKEN	—	yes	Bitbucket Personal Access Token or API token. Required unless provided through ATLASSIAN_DC_MCP_CONFIG_FILE.

Freshness

Active — last maintenance signal 18d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-22 · 18d ago · GitHub
Latest release
2026-09-22 · 18d ago · GitHub · v0.35.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-22 · 18d ago · official registry · v0.35.0

FAQ

›How do I install the Bitbucket MCP server in Claude Code?

Run: claude mcp add bitbucket-b1ff -e BITBUCKET_API_TOKEN='<bitbucket-api-token>' -- npx -y @atlassian-dc-mcp/bitbucket. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Bitbucket require an API key?

Yes. It expects BITBUCKET_API_TOKEN, of which 1 is a secret.

›Can I use Bitbucket as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Bitbucket in the official MCP registry?

Yes, as io.github.b1ff/atlassian-dc-mcp-bitbucket.