MCP Server for Bitbucket API

@JaviMaligno

Repository

Basic information

About MCP Server for Bitbucket API

MCP server for Bitbucket API operations

#bitbucket #api #version-control #git #pipelines #pull-requests #ci-cd #repositories

MCP Server for Bitbucket API config

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

{
  "mcpServers": {
    "bitbucket": {
      "command": "mcp-server-bitbucket",
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-token"
      }
    }
  }
}

MCP Server for Bitbucket API tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Overview

What is MCP Server for Bitbucket API?

MCP Server for Bitbucket API is a Model Context Protocol server that provides comprehensive Bitbucket API operations. It works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client, enabling AI assistants to interact with Bitbucket repositories, pull requests, pipelines, and more.

How to use MCP Server for Bitbucket API?

Install the TypeScript version globally with npm install -g mcp-server-bitbucket or run directly with npx mcp-server-bitbucket. For Python, use pipx install mcp-server-bitbucket. Configure required environment variables (BITBUCKET_WORKSPACE, BITBUCKET_EMAIL, BITBUCKET_API_TOKEN) and add the server to your MCP client (e.g., Claude Code CLI or Cursor IDE).

Key features of MCP Server for Bitbucket API

58 tools covering repositories, pull requests, pipelines, and more
MCP Prompts for reusable workflows (code review, release notes, etc.)
MCP Resources for browsable workspace data
Both TypeScript and Python implementations with identical functionality
Supports custom pipeline triggers with variables and commit hashes
Branch restrictions, webhooks, and permission management

Use cases of MCP Server for Bitbucket API

Automate code review by fetching PR diffs and adding comments
Trigger CI/CD pipelines and monitor their status from an AI assistant
Browse repository files and directories without cloning
Manage repository settings, permissions, and branch protection rules
Generate release notes by comparing commits between versions

Frequently asked questions

What is the difference between the TypeScript and Python versions?

Both versions provide identical functionality. The TypeScript version is recommended for Smithery deployments, while the Python version is stable and can be installed via pipx.

What environment variables are required?

You must set `BITBUCKET_WORKSPACE` (workspace slug), `BITBUCKET_EMAIL` (account email), and `BITBUCKET_API_TOKEN` (repository access token). Optional variables include `API_TIMEOUT` (default 30s) and `MAX_RETRIES` (default 3).

How do I create a Bitbucket API token?

Go to Repository settings > Access tokens in Bitbucket, click Create Repository Access Token, select permissions (Repository: Read/Write/Admin/Delete, Pull requests: Read/Write, Pipelines: Read/Write), and copy the token immediately.

Which MCP clients are supported?

The server works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Are there any rate limits or retry mechanisms?

The server includes a configurable `MAX_RETRIES` environment variable (default 3) to handle rate limiting. No specific rate limit values are mentioned in the README.

Comments

More Version Control MCP servers

GitLab

modelcontextprotocol

Model Context Protocol Servers

88.1K

🚀 GitLab MR MCP

kopfrechner

Interact seamlessly with GitLab repositories to manage merge requests and issues. Fetch details, add comments, and streamline your code review process with ease.

Gerrit Review MCP Server

cayirtepeomer

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

GitHub Stars MCP Server

ccbikai

A Cloudflare-powered MCP (Model Context Protocol) Server that allows you to search and query your GitHub starred repositories using natural language.

111

GitHub MCP Server Extension for Zed

LoamStudios

A GitHub MCP Server extension for Zed