Atlassian Bitbucket MCP Server

Connect AI assistants to Bitbucket Cloud repositories, pull requests, and code via 6 generic API tools.

Unverified

stdio (local)

API key

TypeScript

View repo 156 npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npm install -g @aashari/mcp-server-atlassian-bitbucket

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "atlassian-bitbucket-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-bitbucket"
      ],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

Node.js 18.0.0 or higher
Bitbucket Cloud account (not Bitbucket Server/Data Center)
Scoped API Token (recommended) or legacy App Password with appropriate scopes/permissions

About Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP Server is a Node.js/TypeScript server that gives AI assistants direct access to Bitbucket Cloud through the Model Context Protocol. Version 2.0+ replaced 20+ specific tools with 6 generic HTTP-style tools that can call any Bitbucket Cloud REST API 2.0 endpoint by path, making the server forward-compatible with new Bitbucket features without code changes. It supports workspaces, repositories, branches, commits, file contents, pull requests (create, update, comment, approve, request changes, merge, decline), branch/commit comparison, issues, downloads, pipelines, and deployments. Output defaults to token-efficient TOON format and supports JMESPath filtering and query parameters to minimize token cost. A matching CLI mirrors the MCP tools for direct terminal use.

Tools & capabilities (6)

bb_get

GET any Bitbucket API endpoint to read data. Parameters: path, queryParams?, jq?, outputFormat?.

bb_post

POST to any endpoint to create resources (e.g., create a PR or add a comment). Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_put

PUT to any endpoint to replace resources. Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_patch

PATCH any endpoint for partial updates (e.g., update a PR title). Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_delete

DELETE any endpoint to remove resources (e.g., delete a branch or remove PR approval). Parameters: path, queryParams?, jq?, outputFormat?.

bb_clone

Clone a repository locally. Parameters: workspaceSlug? (uses default if omitted), repoSlug, targetPath (absolute path to parent directory).

When to use it

Explore workspaces, repositories, branches, and commit history with natural language
Read file contents from a specific branch or commit
List, create, update, comment on, approve, request changes on, merge, or decline pull requests
Compare differences between branches or commits
Automate code-review and repository-management workflows for teams and DevOps
Clone repositories locally for further work

Security notes

Runs entirely on your local machine and uses your own Bitbucket credentials; never sends data to third parties. Requires a Bitbucket Cloud Scoped API Token (recommended) or legacy App Password — App Passwords are being deprecated and removed by June 2026, so prefer scoped API tokens. Grant only the scopes you need: 'repository' and 'workspace' for read-only, plus 'pullrequest' for PR management. Bitbucket Cloud only (not Server/Data Center).

Atlassian Bitbucket MCP Server FAQ

What permissions or scopes do I need?

For Scoped API Tokens (recommended): 'repository' and 'workspace' scopes, plus 'pullrequest' for PR management. For legacy App Passwords: Workspaces Read, Repositories Read, Pull Requests Read for read-only; add Write permissions for repositories and pull requests for full functionality.

Does it work with private repositories?

Yes. It works with both public and private repositories, as long as your credentials have the appropriate permissions.

Which AI assistants are supported?

Any MCP-compatible client, including Claude Desktop (official support), Cursor AI, Continue.dev, and Cline.

Does it support Bitbucket Server / Data Center?

No. This server supports Bitbucket Cloud only, not Bitbucket Server or Data Center.

What is TOON output and why is it the default?

TOON (Token-Oriented Object Notation) is a format optimized for LLMs that reduces token consumption by 30-60% versus JSON using tabular arrays and minimal syntax. All tools return TOON by default; you can set outputFormat to 'json' to override.

#bitbucket #atlassian #pull-requests #version-control #code-review #repositories #git #devops

Alternatives to Atlassian Bitbucket MCP Server

Compare all alternatives →

Playwright MCP Server

Developer Tools

24k

Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).

Featured

Verified

stdio (local)

No auth

TypeScript

12 tools

Updated 13 days agoRepo

Context7 MCP Server

Developer Tools

28k

Up-to-date, version-specific library documentation injected into your coding agent.

Verified

stdio (local)

API key

TypeScript

2 tools

Updated 17 days agoRepo

Serena

Developer Tools

12k

LSP-powered coding agent toolkit: semantic symbol search, references and structural edits.

Verified

stdio (local)

No auth

Python

11 tools

Updated 15 days agoRepo

Compare Atlassian Bitbucket MCP Server with:

vs Playwright MCP Server vs Context7 MCP Server vs Serena vs Mobile MCP