Skip to main content
Glama

mcp-bitbucket

by Ibrahimogod

Bitbucket MCP Server

Bitbucket MCP is a high-performance, stateless server that brings the full power of the Bitbucket Cloud API to your automation, CI/CD pipelines, bots, and Rust-based integrations. Built in Rust for speed and reliability, Bitbucket MCP makes it easy to securely access and manage Bitbucket repositories, pull requests, issues, and more—whether you're building developer tools, workflow automation, or DevOps solutions.


Why Bitbucket MCP?

  • Seamless Bitbucket API Integration: Access all major Bitbucket Cloud features—repositories, pull requests, issues, branches, pipelines, deployments, and more—using a modern Rust codebase.
  • Perfect for Automation & Bots: Expose Bitbucket as Model Context Protocol (MCP) tools, ideal for bots, CI/CD, and workflow automation.
  • Secure by Default: Uses only rustls for TLS (no OpenSSL headaches), and supports Bitbucket App Password authentication.
  • Docker-Ready: Deploy anywhere with our prebuilt Docker images on GHCR, or build locally in minutes.
  • Battle-Tested: Comprehensive test suite covers all public API methods, ensuring reliability for your integrations.

Quick Start: Bitbucket API Automation in Rust

1. Use the Prebuilt Docker Image from GHCR

docker run -e BITBUCKET_API_USERNAME=<your_username> -e BITBUCKET_APP_PASSWORD=<your_app_password> -p 8080:8080 ghcr.io/ibrahimogod/bitbucket-mcp:latest

2. Build and Run Locally (Rust)

git clone https://github.com/Ibrahimogod/bitbucket-mcp.git cd bitbucket-mcp cargo build --release $env:BITBUCKET_API_USERNAME="<your_username>" $env:BITBUCKET_APP_PASSWORD="<your_app_password>" cargo run --release --bin bitbucket_stdio

Supported Bitbucket Operations (via MCP)

  • List and manage repositories, workspaces, pull requests, issues, branches, tags, commits
  • Get repository, workspace, and user details
  • Automate pull request workflows: create, update, approve, decline, merge, comment, and manage tasks
  • Integrate with Bitbucket pipelines, deployments, downloads, webhooks, snippets, and projects
  • See src/common/bitbucket.rs for the full API

Bitbucket Authentication

  • Create a Bitbucket App Password with Repository:Read and Pull requests:Read permissions.
  • Set BITBUCKET_API_USERNAME to your Atlassian email.
  • Set BITBUCKET_APP_PASSWORD to your App Password.

Project Structure

  • src/common/bitbucket.rs — Bitbucket API integration logic
  • src/bitbucket_stdio.rs — Server entry point
  • Cargo.toml — Dependency configuration (uses rustls only)
  • Dockerfile — Multi-stage build, no OpenSSL
  • tests/bitbucket.rs — Full test suite for all public API methods

License

MIT


Bitbucket MCP is the best way to automate Bitbucket Cloud with Rust, bots, or CI/CD. Star the repo and try it today!


Example: VS Code MCP Settings for Docker Integration

You can configure the VS Code MCP extension to launch the Bitbucket MCP server automatically using Docker. Add the following to your .vscode/settings.json (or your global MCP settings file):

{ "mcp": { "servers": { "bitbucket-mcp-docker": { "command": "docker", "args": [ "run", "-i", "-e", "BITBUCKET_API_USERNAME", "-e", "BITBUCKET_APP_PASSWORD", "-e", "RUST_BACKTRACE", "ghcr.io/ibrahimogod/bitbucket-mcp:latest" ], "env": { "BITBUCKET_API_USERNAME": "<your_username>", "BITBUCKET_APP_PASSWORD": "<your_app_password>", "RUST_BACKTRACE": "1" } } } } }

Replace <your_username> and <your_app_password> with your Bitbucket credentials. You can also specify a particular image tag instead of latest if needed.

This configuration allows the MCP extension to start the Bitbucket MCP server in Docker automatically when you use Bitbucket tools in VS Code.


Example: Cursor MCP Settings for Docker Integration

You can configure Cursor to launch the Bitbucket MCP server automatically using Docker. Add the following to your .cursor/mcp.json (for project) or ~/.cursor/mcp.json (for global use):

{ "mcpServers": { "bitbucket-mcp-docker": { "command": "docker", "args": [ "run", "-i", "-e", "BITBUCKET_API_USERNAME", "-e", "BITBUCKET_APP_PASSWORD", "-e", "RUST_BACKTRACE", "ghcr.io/ibrahimogod/bitbucket-mcp:latest" ], "env": { "BITBUCKET_API_USERNAME": "<your_username>", "BITBUCKET_APP_PASSWORD": "<your_app_password>", "RUST_BACKTRACE": "1" } } } }

Replace <your_username> and <your_app_password> with your Bitbucket credentials. You can also specify a particular image tag instead of latest if needed.

This configuration allows Cursor to start the Bitbucket MCP server in Docker automatically when you use Bitbucket tools.

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Access all major Bitbucket Cloud features—repositories, pull requests, issues, branches, pipelines, deployments, and more—using a modern Rust codebase. Expose Bitbucket as Model Context Protocol (MCP) tools, ideal for bots, CI/CD, and workflow automation.

  1. Why Bitbucket MCP?
    1. Quick Start: Bitbucket API Automation in Rust
      1. Use the Prebuilt Docker Image from GHCR
      2. Build and Run Locally (Rust)
    2. Supported Bitbucket Operations (via MCP)
      1. Bitbucket Authentication
        1. Project Structure
          1. License
            1. Example: VS Code MCP Settings for Docker Integration
              1. Example: Cursor MCP Settings for Docker Integration

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  Facilitates interaction with Bitbucket Server for pull request management using the MCP protocol, supporting operations such as creating, merging, commenting, and reviewing pull requests.
                  Last updated -
                  7
                  18
                  JavaScript
                  Apache 2.0
                • -
                  security
                  F
                  license
                  -
                  quality
                  Provides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.
                  Last updated -
                  JavaScript
                • A
                  security
                  F
                  license
                  A
                  quality
                  A Python implementation of an MCP server that enables secure, local Bitbucket integration for AI applications, providing tools for repository management, branch creation, file operations, issue tracking, and pull request creation.
                  Last updated -
                  10
                  3
                  Python
                  • Apple
                  • Linux
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI assistants to interact with Bitbucket repositories, pull requests, and other resources through Bitbucket Cloud and Server APIs.
                  Last updated -
                  3
                  85
                  4
                  JavaScript
                  MIT License
                  • Linux
                  • Apple

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ibrahimogod/bitbucket-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server