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

Basic information

Category

Version Control

License

MIT

Runtime

node

Transports

stdio

Publisher

MatanYemini

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.

Comments

More Version Control MCP servers

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

Atlassian Data Center MCP

b1ff

MCP servers for the Atlassian products (Bitbucket, Confluence, JIRA) of the Data Center version

81

Linear MCP Server

cline

a private MCP server for accessing Linear

133

AIO-MCP Server

athapong

🚀 All-in-one MCP server with AI search, RAG, and multi-service integrations (GitLab/Jira/Confluence/YouTube) for AI-enhanced development workflows. Folk from https://github.com/nguyenvanduocit/all-in-one-model-context-protocol

36

Git

modelcontextprotocol

Model Context Protocol Servers

88.1K