← Back to directory
A

Atlassian Dc MCP Bitbucket

Community
MCP server for Atlassian Bitbucket Data Center - interact with repositories and code.
Category
Dev Tools #258 of 438
Stars
★ 103 Popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
API key / credential required
License
MIT
Last commit
50FMRS · D

A community-developed Bitbucket Data Center MCP server offering repository interaction, but not an official product.

Strongest · Setup experience 14/20 Weakest · Reliability 6/20

Reliability
6/20
Security and permissions
13/20
Maintenance
7/20
Documentation
10/20
Setup experience
14/20
Why each score
Reliability 6/20
Only the manifest and README were supplied; no source, tests, or CI workflow for the Bitbucket server. The MCP init/tool-list handshake and tool behavior cannot be verified. The README and manifest are internally consistent and the happy path seems plausible, but verifiable execution evidence is missing, so a conservative 6 is given.
Security and permissions 13/20
Credential handling is well designed: the token is marked secret, macOS Keychain and POSIX 0600 files are supported, precedence is explicit, and examples contain no real secrets; no red-line issues. However, no source is available to confirm tokens are not logged or exfiltrated, and the Bitbucket tool set is unknown, so least privilege, destructive-operation confirmation, and data boundaries cannot be verified; score is 13.
Maintenance 7/20
The repository is not archived, has an MIT license, a version number, and tracked open issues, indicating some maintenance. However, no evidence of commit history, release cadence, dependency updates, or a security-response channel was supplied, so sustained maintenance cannot be confirmed; score is 7.
Documentation 10/20
The README thoroughly covers installation, authentication, configuration precedence, Claude Desktop/Code examples, and platform differences. However, tool-level documentation for the Bitbucket server (tool list, parameters, limits, troubleshooting) is absent, and there is no reviewable test/CI evidence, so the score is 10.
Setup experience 14/20
Setup is clearly documented: npx startup, interactive setup, CLI flags, non-interactive mode, macOS/Linux/Windows notes, and mainstream client configuration examples are all provided with few steps. However, the static calibration caps this dimension at 15 and no CI/test execution evidence is available, so a conservative 14 is given.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Developers using Atlassian Bitbucket Data Center
  • Teams that want to integrate repository management into MCP environments

Not for

  • Users of Atlassian Cloud (server is only for Data Center)
  • Scenarios requiring official Atlassian support for Bitbucket

Required permissions

  • Read and write access to Bitbucket repositories
  • Requires a Bitbucket API token

Risks and side effects

  • Token may be exposed; store securely
  • Not officially supported by Atlassian; may lack stability

Setup

Before you start

Runtime:Node.js 18+

BITBUCKET_API_TOKEN optionalsecret Bitbucket Personal Access Token or API token, created under Manage Account > HTTP access tokens.
Other optional settings (4)
BITBUCKET_HOST optional Bitbucket instance domain (e.g. your-instance.atlassian.net, no protocol); alternative to BITBUCKET_API_BASE_PATH.
BITBUCKET_API_BASE_PATH optional Full API base URL including protocol (e.g. https://host/rest); alternative to BITBUCKET_HOST.
ATLASSIAN_DC_MCP_CONFIG_FILE optional Optional absolute path to a shared dotenv-style config file holding credentials for multiple products.
ATLASSIAN_DC_MCP_REQUEST_TIMEOUT_MS optional Optional positive millisecond value overriding the default 30-second API request timeout.

Run npx @atlassian-dc-mcp/bitbucket setup for interactive setup, or configure environment variables directly. Add the server to Claude Desktop or Claude Code using the npx command and BITBUCKET_HOST and BITBUCKET_API_TOKEN environment variables.

claude_desktop_config.json
{
  "mcpServers": {
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/bitbucket"
      ],
      "env": {
        "BITBUCKET_HOST": "your-bitbucket-host",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "atlassian-bitbucket-dc": {
      "command": "npx",
      "args": [
        "-y",
        "@atlassian-dc-mcp/bitbucket"
      ],
      "env": {
        "BITBUCKET_HOST": "your-bitbucket-host",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add atlassian-bitbucket-dc -e BITBUCKET_HOST=your-bitbucket-host -e BITBUCKET_API_TOKEN=your-token -- npx -y @atlassian-dc-mcp/bitbucket

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

Run npx @atlassian-dc-mcp/bitbucket setup to store credentials, then connect the atlassian-bitbucket-dc server in Claude Desktop or Claude Code and ask it to list your Bitbucket repositories; a returned repository list confirms the connection works.

Troubleshooting

  1. Ensure BITBUCKET_HOST or BITBUCKET_API_BASE_PATH is set
  2. Verify BITBUCKET_API_TOKEN is valid and not expired
  3. Check logs or run setup to revalidate credentials

Things to try

Once connected, you can ask your AI assistant things like:

  • List the repositories on my Bitbucket instance
  • Show details for the repository my-project/my-repo
  • Search my Bitbucket repos for code containing TODO
  • Show the recent commits in this repository

Use cases

Let AI assistants directly access and operate on Bitbucket repositories and code.
Automate code review, branch management, and commit information extraction.

Supported clients

Claude Desktop
Claude Code

Listed from the project's documentation, not tested by this site.

Overview

This is a community-maintained MCP server for Atlassian Bitbucket Data Center, providing tools to interact with repositories and code. Note: This project is not affiliated with, endorsed by, or supported by Atlassian.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

Source revision f12476955c0d Data synced 2026-10-12 Read the FMRS scoring method