A
security-
licenseA
qualityFacilitates 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 -
37
Apache 2.0
Provides comprehensive access to Bitbucket Cloud API features for managing repositories, pull requests, issues, branches, pipelines, deployments, webhooks, and more. Supports automation of pull request workflows including creation, approval, merging and commenting.
Enables deployment of the MCP server using Docker containers, with prebuilt images available on GitHub Container Registry (GHCR) for easy deployment in containerized environments.
Integrates with GitHub for package distribution via GitHub Container Registry (GHCR) and release management, allowing users to access prebuilt Docker images and releases from GitHub.
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
rustlsfor 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
Find all tags/releases at: GitHub Releases
See GHCR package
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.rsfor the full API
Bitbucket Authentication
Create a Bitbucket App Password with
Repository:ReadandPull requests:Readpermissions.Set
BITBUCKET_API_USERNAMEto your Atlassian email.Set
BITBUCKET_APP_PASSWORDto your App Password.
Project Structure
src/common/bitbucket.rs— Bitbucket API integration logicsrc/bitbucket_stdio.rs— Server entry pointCargo.toml— Dependency configuration (usesrustlsonly)Dockerfile— Multi-stage build, no OpenSSLtests/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.
This server cannot be installed
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.
Related MCP Servers
- -security-license-qualityProvides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.Last updated -
- Asecurity-licenseAqualityA 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 -340445MIT License
- Asecurity-licenseAqualityAn MCP server that enables interaction with Bitbucket repositories through the Model Context Protocol, supporting both Bitbucket Cloud and Server with features for PR lifecycle management and code review.Last updated -1982011MIT License