Log inSubmit server
MCP Server Bitbucket logo

MCP Server Bitbucket

by JaviMaligno

Connects AI agents to Bitbucket Cloud with 58 tools for repositories, pull requests, pipelines, and source management.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server Bitbucket

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "javimaligno-mcp-server-bitbucket": {
      "command": "npx",
      "args": [
        "mcp-server-bitbucket"
      ],
      "env": {
        "BITBUCKET_WORKSPACE": "YOUR_VALUE_HERE",
        "BITBUCKET_EMAIL": "YOUR_VALUE_HERE",
        "BITBUCKET_API_TOKEN": "YOUR_VALUE_HERE",
        "BITBUCKET_OAUTH_TOKEN": "YOUR_VALUE_HERE",
        "BITBUCKET_AUTH_TYPE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

JaviMaligno/mcp-server-bitbucket connects MCP-compatible clients to Bitbucket API operations for repository administration, pull requests, pipelines, branches, commits, deployments, webhooks, tags, and source browsing. It is available as TypeScript for Node.js or Python, and exposes 58 tools through a local stdio process or hosted deployment. Authentication supports either an Atlassian API token with email-based Basic Auth or a workspace, project, or repository access token using Bearer Auth. Reach for it when an agent needs to inspect or modify Bitbucket resources without cloning repositories or switching to a separate command-line workflow.

Use cases

  • Manage Bitbucket repositories from an AI coding client
  • Review and update pull requests with comments and diffs
  • Trigger, monitor, inspect, and stop Bitbucket Pipelines
  • Browse repository files without cloning them
  • Administer pipeline variables, tags, webhooks, and branch restrictions

Key features

  • 58 Bitbucket API tools
  • Repository and pull request management
  • Pipeline execution, logs, and variables
  • Source browsing without cloning
  • Basic Auth and Bearer Auth support
  • TypeScript and Python implementations

Tools26

What MCP Server Bitbucket lets your agent do. Expand a tool for its parameters.

Self-reported~215 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

5/5 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · mcp-server-bitbucket (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads176Package downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Tools exposed26Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server Bitbucket works

What JaviMaligno/mcp-server-bitbucket does

JaviMaligno/mcp-server-bitbucket exposes Bitbucket Cloud API operations through the Model Context Protocol. Its 58 tools cover repository discovery and administration, pull requests, Pipelines, branches, commits, deployments, webhooks, tags, branch restrictions, permissions, and source browsing. Agents can read files and directory listings directly from Bitbucket rather than cloning a repository.

Pull request workflows include listing and inspecting requests, creating and merging them, approving or declining them, requesting changes, reading comments, adding comments, and retrieving diffs. Pipeline tools cover recent runs, status, logs, triggering, stopping, and pipeline variables. The package also provides MCP prompts for reusable workflows and MCP resources for browsable workspace data.

How it works

The project contains TypeScript and Python implementations with matching functionality. The TypeScript package can be installed globally with npm or started with npx; the Python implementation can be installed with pipx. Both can run as local MCP servers and connect to clients such as Claude Code, Claude Desktop, and Cursor.

Bitbucket requests use one of two authentication modes. Personal Atlassian API tokens use Basic Auth with the account email and token. Workspace, project, or repository access tokens use Bearer Auth through BITBUCKET_OAUTH_TOKEN. The server can select the mode automatically or accept an explicit BITBUCKET_AUTH_TYPE value.

Setup and configuration

Set BITBUCKET_WORKSPACE to the Bitbucket workspace slug. For Basic Auth, also set BITBUCKET_EMAIL and BITBUCKET_API_TOKEN. For a workspace-owned access token, use BITBUCKET_OAUTH_TOKEN instead of the email and Basic Auth combination. The TypeScript implementation requires Node.js 22 or newer in the supported patched releases, while the Python implementation requires Python 3.11 or newer.

Optional request controls include API_TIMEOUT, which defaults to 30 seconds, and MAX_RETRIES, which defaults to three attempts for rate-limited requests. A typical local installation uses npm install -g mcp-server-bitbucket or pipx install mcp-server-bitbucket. Claude Code and Cursor configurations pass the Bitbucket variables to the MCP process through their client settings.

Hosted deployments can protect the remote /mcp endpoint with an external OAuth authorization server. MCP_OAUTH_ISSUER and MCP_OAUTH_AUDIENCE enable this protection; related settings can define the signing-key URL, required scope, and public server URL. The health endpoint remains open, while authenticated requests are checked for JWT signature, issuer, audience, expiry, and scope. Bitbucket calls still use the server's configured credential.

Tools and capabilities

  • Manage repositories, including listing, searching, creating, deleting, and updating settings.
  • Review pull requests, comments, and diffs, then create, approve, merge, decline, or request changes.
  • Inspect, start, stop, and troubleshoot Bitbucket Pipelines through statuses and logs.
  • Manage pipeline variables and access repository, branch, commit, deployment, webhook, tag, and restriction data.
  • Browse source files and directories without a local clone.
  • Use MCP prompts and resources for reusable workflows and workspace browsing.

Limitations and notes

The server operates against Bitbucket using its configured credential, including when a remote deployment is protected by OAuth. Remote OAuth therefore controls access to the MCP endpoint but does not attribute individual Bitbucket actions to separate users. The TypeScript and Python versions are intended to provide the same functionality, while the TypeScript version is the deployment choice for Smithery.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server Bitbucket

JaviMaligno/mcp-server-bitbucket is an MCP server that connects AI clients to the Bitbucket API. Its main tools manage repositories, pull requests, Pipelines, pipeline variables, branches, commits, deployments, webhooks, tags, branch restrictions, permissions, and source files through 58 MCP tools.

Install the TypeScript package with `npm install -g mcp-server-bitbucket` or run it with `npx mcp-server-bitbucket`; install the Python version with `pipx install mcp-server-bitbucket`. Configure the required Bitbucket environment variables in your MCP client.

Yes, JaviMaligno/mcp-server-bitbucket works with Cursor. Add the server command and Bitbucket environment variables to `~/.cursor/mcp.json`, using either the npm/npx TypeScript command or the installed Python command.

It supports Basic Auth with `BITBUCKET_EMAIL` and `BITBUCKET_API_TOKEN`, or Bearer Auth with `BITBUCKET_OAUTH_TOKEN`. The server detects the mode automatically unless `BITBUCKET_AUTH_TYPE` explicitly selects `basic` or `bearer`.

Related MCP servers

All in Version Control All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server Bitbucket AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/javimaligno-mcp-server-bitbucket?style=directory)](https://allmcps.com/mcp/javimaligno-mcp-server-bitbucket)
HTML Embed
<a href="https://allmcps.com/mcp/javimaligno-mcp-server-bitbucket"><img src="https://allmcps.com/api/badge/javimaligno-mcp-server-bitbucket?style=directory" alt="MCP Server Bitbucket on AllMCPs" /></a>