Bitbucket MCP Server

@MatanYemini

Repository

Basic information

About Bitbucket MCP Server

Bitbucket MCP - A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs

#mcp #bitbucket #ai-tools #llm-agents #model-context-protocol #mcp-server #antrophic

Bitbucket MCP Server config

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

{
  "mcpServers": {
    "bitbucket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bitbucket-mcp@latest"
      ]
    }
  }
}

Bitbucket MCP Server 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.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Bitbucket MCP?

A Model Context Protocol (MCP) server that integrates AI assistants like Cursor with Bitbucket Cloud and Server APIs, enabling interaction with repositories and pull requests.

How to use Bitbucket MCP?

Run via npx -y bitbucket-mcp@latest or install globally/project‑wise with npm, then set environment variables (BITBUCKET_URL, BITBUCKET_USERNAME, BITBUCKET_PASSWORD or BITBUCKET_TOKEN, BITBUCKET_WORKSPACE). Configure as an MCP tool in Cursor using the provided JSON snippet.

Key features of Bitbucket MCP

No destructive operations by default (safe design)
List, get, create, update, and merge pull requests
List and get repository details
Pagination with automatic following of next links (up to 1,000 items)
Automatic workspace extraction from URL (legacy mode)
CodeQL security scanning on every code change

Use cases of Bitbucket MCP

List all repositories in a Bitbucket workspace from an AI chat
Fetch open pull requests for a repository to assist code review
Create a pull request with title, description, and reviewer list
Approve, merge, or decline a pull request without leaving the assistant
View pull request activity logs to understand recent changes

Frequently asked questions

What authentication methods are supported?

Either a Bitbucket app password (`BITBUCKET_USERNAME` + `BITBUCKET_PASSWORD`) or an access token (`BITBUCKET_TOKEN`) is required. App passwords need at least Repositories: Read permission.

How do I resolve 401 authentication errors?

Verify you are using an app password (not your regular password) and that it has the necessary permissions. Try the direct API URL `https://api.bitbucket.org/2.0` and test credentials with `curl`.

What is the `BITBUCKET_ENABLE_DANGEROUS` flag?

When set to `true`, it enables destructive operations (e.g., deletions). By default, no DELETE operations are exposed to ensure safety.

Does the server support pagination for large result sets?

Yes. Listing tools accept `pagelen` (default 10, max 100), `page`, and `all`. When `all=true`, the server automatically follows Bitbucket `next` links up to 1,000 entries.

Where can I find the server logs?

Logging can be disabled with `BITBUCKET_LOG_DISABLE`. Log files are stored in the OS‑specific app log directory, configurable via `BITBUCKET_LOG_DIR` and `BITBUCKET_LOG_FILE`.

Comments

More Version Control MCP servers

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.