Atlassian Bitbucket MCP Server
@aashari
About Atlassian Bitbucket MCP Server
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.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-server-atlassian-bitbucket": {
"command": "npx",
"args": [
"-y",
"@aashari/mcp-server-atlassian-bitbucket",
"get",
"--path",
"/workspaces"
]
}
}
}Tools
6GET any Bitbucket API endpoint (read data)
POST to any endpoint (create resources)
PUT to any endpoint (replace resources)
PATCH any endpoint (partial updates)
DELETE any endpoint (remove resources)
Clone a repository locally
Overview
What is Atlassian Bitbucket MCP Server?
Atlassian Bitbucket MCP Server connects AI assistants like Claude and Cursor AI directly to Bitbucket Cloud repositories, pull requests, and code. It allows developers, team leads, and DevOps engineers to interact with Bitbucket using natural language for code reviews, repository management, and workflow automation.
How to use Atlassian Bitbucket MCP Server?
Configure your MCP-compatible AI assistant to run npx -y @aashari/mcp-server-atlassian-bitbucket with environment variables for authentication. For Claude Desktop, add the server configuration to ~/.claude/claude_desktop_config.json. Set credentials via ATLASSIAN_USER_EMAIL plus ATLASSIAN_API_TOKEN (recommended) or ATLASSIAN_BITBUCKET_USERNAME plus ATLASSIAN_BITBUCKET_APP_PASSWORD. Optionally set BITBUCKET_DEFAULT_WORKSPACE in a config file at ~/.mcp/configs.json.
Key features of Atlassian Bitbucket MCP Server
- Provides 6 generic tools (
bb_get,bb_post,bb_put,bb_patch,bb_delete,bb_clone) for Bitbucket API access - Supports TOON output format reducing token consumption by 30-60% vs JSON
- Includes JMESPath (
jq) filtering to extract specific data and reduce costs - Supports branching, commits, pull requests, diffs, comments, approvals, and merges
- Offers scoped API token (future-proof) and legacy app password authentication methods
- Works with any MCP-compatible client including Claude Desktop, Cursor AI, Continue.dev, and Cline
Use cases of Atlassian Bitbucket MCP Server
- Ask AI about latest commits, open pull requests, or repository details in natural language
- Automate code reviews by having AI analyze PR diffs and add comments
- Manage pull requests—create, approve, merge, decline, or request changes via conversation
- Generate quick insights into project status, branch activity, and deployment pipelines
FAQ from Atlassian Bitbucket MCP Server
What are the runtime requirements?
Node.js 18.0.0 or higher and a Bitbucket Cloud account (not Bitbucket Server/Data Center).
How do I authenticate?
Use a scoped API token (recommended, future-proof) or an App Password (legacy, deprecated by June 2026). For tokens, set ATLASSIAN_USER_EMAIL and ATLASSIAN_API_TOKEN. For app passwords, set ATLASSIAN_BITBUCKET_USERNAME and ATLASSIAN_BITBUCKET_APP_PASSWORD.
What APIs and endpoints are available?
All Bitbucket Cloud REST API 2.0 endpoints are accessible. Common paths include workspaces, repositories, branches, commits, pull requests, diffs, comments, approvals, merges, issues, pipelines, and deployments.
How is this different from alternatives?
Generic tools give access to any Bitbucket API endpoint without being locked to predefined actions. TOON output format and JMESPath filtering reduce token costs significantly compared to raw JSON responses.
Does the server support local cloning?
Yes, the bb_clone tool allows cloning a repository locally by specifying workspaceSlug, repoSlug, and targetPath.
Frequently asked questions
What are the runtime requirements?
Node.js 18.0.0 or higher and a Bitbucket Cloud account (not Bitbucket Server/Data Center).
How do I authenticate?
Use a scoped API token (recommended, future-proof) or an App Password (legacy, deprecated by June 2026). For tokens, set `ATLASSIAN_USER_EMAIL` and `ATLASSIAN_API_TOKEN`. For app passwords, set `ATLASSIAN_BITBUCKET_USERNAME` and `ATLASSIAN_BITBUCKET_APP_PASSWORD`.
What APIs and endpoints are available?
All Bitbucket Cloud REST API 2.0 endpoints are accessible. Common paths include workspaces, repositories, branches, commits, pull requests, diffs, comments, approvals, merges, issues, pipelines, and deployments.
How is this different from alternatives?
Generic tools give access to any Bitbucket API endpoint without being locked to predefined actions. TOON output format and JMESPath filtering reduce token costs significantly compared to raw JSON responses.
Does the server support local cloning?
Yes, the `bb_clone` tool allows cloning a repository locally by specifying `workspaceSlug`, `repoSlug`, and `targetPath`.
Basic information
More Version Control MCP servers
mcp-github-trending MCP Server
hetaoBackendMCP server for getting github trending repos & developers
Bitbucket MCP
MatanYeminiBitbucket MCP - A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs
Git
modelcontextprotocolModel Context Protocol Servers
Atlassian Jira MCP Server
aashariNode.js/TypeScript MCP server for Atlassian Jira. Equips AI systems (LLMs) with tools to list/get projects, search/get issues (using JQL/ID), and view dev info (commits, PRs). Connects AI capabilities directly into Jira project management and issue tracking workflows.
Gitlab Mcp Server
jmrplensOpen source GitLab MCP server for AI assistants: 2-tool dynamic find/execute over 860+ GitLab actions (1,000+ Enterprise), stdio/HTTP/OAuth, safe/read-only modes.
Comments