MCP.so
Sign In

Bitbucket MCP

@MatanYemini

Repository

About Bitbucket MCP

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

Config

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

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

Tools

No tools detected

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

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

FAQ from Bitbucket MCP

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.

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

Basic information

Category

Version Control

License

MIT

Transports

stdio

Author

MatanYemini

More Version Control MCP servers

mcp-github-trending MCP Server

hetaoBackend

MCP server for getting github trending repos & developers

53

Linear MCP Server

cline

a private MCP server for accessing Linear

133

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.

37

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

GitLab

modelcontextprotocol

Model Context Protocol Servers

88.1K