Personal Bitbucket MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with tools to interact with Bitbucket Cloud repositories. Built with Quarkus, the

Local serverstdioGo

What is the Personal Bitbucket MCP Server?

A Model Context Protocol (MCP) server that provides AI assistants with tools to interact with Bitbucket Cloud repositories. Built with Quarkus, the Supersonic

The short version

The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). This server implements MCP to expose Bitbucket operations as tools that AI assistants like Claude, ChatGPT, or other LLM-powered applications can use.

  • 🔧 11 MCP Tools for Bitbucket operations
  • 🚀 Native Image Support with GraalVM for fast startup and low memory footprint
  • 🐳 Multi-Architecture Docker Images (AMD64 & ARM64)
  • 🔐 Secure Authentication using Bitbucket App Passwords
  • 📦 RESTful API for direct HTTP access
  • ⚡ Multiple Transport Options - stdio (universal), SSE, and HTTP Stream

What it needs from you

  1. Bitbucket API Token: Create an API token at https://bitbucket.org/account/settings/api-token/ - Required permissions: repository:read, pullrequest:read, pullrequest:write - See Creating a Bitbucket API Token for detailed instructions 2. Docker (optional): For running the containerized version

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Personal Bitbucket MCP Server

{
  "mcpServers": {
    "bitbucket": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BITBUCKET_EMAIL=your-email@example.com",
        "-e",
        "BITBUCKET_API_TOKEN=your-api-token",
        "-e",
        "BITBUCKET_WORKSPACE=your-workspace",
        "subrutin/bitbucket-mcp-server:stdio-0.0.2"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  1. Bitbucket API Token: Create an API token at https://bitbucket.org/account/settings/api-token/ - Required permissions: repository:read, pullrequest:read, pullrequest:write - See Creating a Bitbucket API Token for detailed instructions 2. Docker (optional): For running the containerized version

Example prompts to try

  • “Use Personal Bitbucket to Repositories.”
  • “Use Personal Bitbucket to Prerequisites.”
  • “Use Personal Bitbucket to Logs.”

Frequently asked questions

A Model Context Protocol (MCP) server that provides AI assistants with tools to interact with Bitbucket Cloud repositories. Built with Quarkus, the Supersonic Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.