Atlassian Bitbucket MCP Server

@guenichone

About Atlassian Bitbucket MCP Server

Atliassian Bitbucket MCP Server for self hosted bitbucket server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "atlassian-bitbucket-server-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "bitbucket-mcp-server",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Atlassian Bitbucket MCP Server?

This server integrates Atlassian Bitbucket Server/Data Center with AI systems via the Model Context Protocol. It provides access to projects, repositories, branches, files, and pull requests through a type-safe API.

How to use Atlassian Bitbucket MCP Server?

Install Node.js v20+, npm, Python 3, and a Bitbucket access token. Clone the repository, run npm install and npm run build-app, then set required environment variables and start the server with npm start (STDIO) or by setting MCP_TRANSPORT=sse (HTTP/SSE). Docker usage is also available via Docker CLI or the included Makefile.

Key features of Atlassian Bitbucket MCP Server

Access to projects, repositories, branches, and files.
Tools for working with pull requests.
Type-safe integration with official Bitbucket OpenAPI specs.
Supports STDIO and HTTP/SSE transports.
Docker deployment via CLI or Makefile.
Configuration via environment variables.

Use cases of Atlassian Bitbucket MCP Server

AI-assisted code review by fetching and analyzing pull requests.
Automated repository management through AI agents.
Repository and branch queries via natural language.
Integration with AI coding assistants for file operations.

FAQ from Atlassian Bitbucket MCP Server

What Bitbucket versions are supported?

The server is designed for Atlassian Bitbucket Server/Data Center, not Bitbucket Cloud.

What are the runtime requirements?

Node.js v20+, npm, and Python 3 (for the OpenAPI filtering script) are required.

How do I authenticate?

Set the ATLASSIAN_BITBUCKET_ACCESS_TOKEN environment variable with a valid Bitbucket access token.

What transports are supported?

STDIO (default) and SSE (HTTP) are supported. Set MCP_TRANSPORT=sse to use HTTP/SSE transport.

Is Docker supported?

Yes. You can build and run the server using Docker CLI or the provided Makefile.

Frequently asked questions

What Bitbucket versions are supported?

The server is designed for Atlassian Bitbucket Server/Data Center, not Bitbucket Cloud.

What are the runtime requirements?

Node.js v20+, npm, and Python 3 (for the OpenAPI filtering script) are required.

How do I authenticate?

Set the `ATLASSIAN_BITBUCKET_ACCESS_TOKEN` environment variable with a valid Bitbucket access token.

What transports are supported?

STDIO (default) and SSE (HTTP) are supported. Set `MCP_TRANSPORT=sse` to use HTTP/SSE transport.

Is Docker supported?

Yes. You can build and run the server using Docker CLI or the provided Makefile.

Comments

Basic information

More Version Control MCP servers

Gitlab Mcp Server

jmrplens

Open source GitLab MCP server for AI assistants: 2-tool dynamic find/execute over 860+ GitLab actions (1,000+ Enterprise), stdio/HTTP/OAuth, safe/read-only modes.