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

Integrate MCP with GitHub Copilot

skills

Learn how to use MCP Servers with GitHub Copilot

225

Git MCP Server

cyanheads

A Git MCP server for AI agents. STDIO & Streamable HTTP.

225

MCP GitHub Project Manager

kunwarVivek

a mcp server to manage github project's functionality

Atlassian Bitbucket MCP Server

aashari

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.

157

MCP Linear

tacticlaunch

MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.

141