MCP Server for Bitbucket API

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

FAQ from MCP Server for Bitbucket API

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.