Bitbucket
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 standa
What is Bitbucket?
Bitbucket is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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 direct...
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 standa
This server falls under the Version Control category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Node.js/TypeScript MCP server for Atlassian Bitbucket. Enabl
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @aashari/mcp-server-atlassian-bitbucketManual Installation
npx -y @aashari/mcp-server-atlassian-bitbucketConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bitbucket
The Atlassian Bitbucket MCP Server is a Node.js/TypeScript package that lets AI assistants interact directly with Bitbucket workspaces, repositories, and pull requests through the standard MCP protocol. It exposes six HTTP-method-style tools (bb_get, bb_post, bb_put, bb_patch, bb_delete, bb_clone) that cover the full Bitbucket REST API, enabling tasks like listing repositories, reviewing pull requests, posting review comments, and cloning repos locally. Responses use a compact TOON format that reduces token consumption by 30–60% compared to raw JSON.
Prerequisites
- Node.js 18 or later installed on your machine
- An Atlassian account with access to a Bitbucket workspace
- An Atlassian API token (scoped token starting with ATATT, generated at id.atlassian.com/manage-profile/security/api-tokens) or a Bitbucket App Password
- Your Atlassian account email address
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
Generate an Atlassian API token
Go to id.atlassian.com → Security → API tokens and create a new token. Copy the token value (it starts with ATATT). Alternatively, create a Bitbucket App Password under Bitbucket settings → App passwords with Repository and Pull Request read/write scopes.
Test the server with npx
Run a quick test to confirm your credentials work before adding the server to your client config.
[email protected] \
ATLASSIAN_API_TOKEN=ATATT... \
npx -y @aashari/mcp-server-atlassian-bitbucket get --path "/workspaces"Configure environment variables
Set the required credentials as environment variables. BITBUCKET_DEFAULT_WORKSPACE is optional but saves you from typing the workspace slug in every request.
export ATLASSIAN_USER_EMAIL="[email protected]"
export ATLASSIAN_API_TOKEN="ATATT..."
export BITBUCKET_DEFAULT_WORKSPACE="my-workspace"Add the server to your MCP client config
Edit your MCP client configuration file to register the Bitbucket server. The server is invoked via npx so no global install is required.
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"],
"env": {
"ATLASSIAN_USER_EMAIL": "[email protected]",
"ATLASSIAN_API_TOKEN": "ATATT...",
"BITBUCKET_DEFAULT_WORKSPACE": "my-workspace"
}
}
}
}Restart your MCP client
Restart Claude Desktop or your chosen MCP client so it detects the new server. The Bitbucket tools (bb_get, bb_post, etc.) will appear in the available tool list.
Bitbucket Examples
Client configuration
Full claude_desktop_config.json entry for the Bitbucket MCP server using an Atlassian scoped API token.
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"],
"env": {
"ATLASSIAN_USER_EMAIL": "[email protected]",
"ATLASSIAN_API_TOKEN": "ATATT3xFfGF0...",
"BITBUCKET_DEFAULT_WORKSPACE": "my-workspace",
"DEBUG": "false"
}
}
}
}Prompts to try
Natural-language prompts to send to your AI assistant after the server is connected.
- "List all repositories in my Bitbucket workspace"
- "Show me all open pull requests that need review"
- "Create a PR from feature/login-fix to main with title 'Fix login redirect'"
- "Add a review comment to PR #42 asking about error handling in line 85"
- "Get the content of src/auth.ts from the main branch of my-repo"
- "Compare my feature branch against main and summarize the diff"Troubleshooting Bitbucket
401 Unauthorized when making API calls
Confirm ATLASSIAN_USER_EMAIL matches the account that owns the token. If using a scoped token (ATATT prefix), ensure it has Bitbucket read/write permissions. App passwords require ATLASSIAN_BITBUCKET_USERNAME and ATLASSIAN_BITBUCKET_APP_PASSWORD instead.
Workspace not found errors
The workspace slug is the short URL-safe identifier (e.g., 'my-company'), not the display name. Check your Bitbucket URL: bitbucket.org/<workspace-slug>. Set BITBUCKET_DEFAULT_WORKSPACE to this slug.
npx takes too long on first run
Install the package globally once with `npm install -g @aashari/mcp-server-atlassian-bitbucket` and then use the command `mcp-server-atlassian-bitbucket` directly instead of npx.
Frequently Asked Questions about Bitbucket
What is Bitbucket?
Bitbucket is a Model Context Protocol (MCP) server that 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 standa It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Bitbucket?
Install via npm with the command: npx -y @aashari/mcp-server-atlassian-bitbucket. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Bitbucket?
Bitbucket works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Bitbucket free to use?
Yes, Bitbucket is open source and available under the ISC License license. You can use it freely in both personal and commercial projects.
Bitbucket Alternatives — Similar Version Control Servers
Looking for alternatives to Bitbucket? Here are other popular version control servers you can use with Claude, Cursor, and VS Code.
Ruiyu MA
★ 30.1kConnect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
GitMCP
★ 8.1kTransforms any GitHub repository or GitHub Pages site into a documentation hub for AI assistants using the Model Context Protocol. It allows AI tools to access real-time code and documentation to prevent hallucinations and provide accurate API usage
GitHub Codemunch
★ 1.8kA token-efficient MCP server for exploring GitHub repositories using tree-sitter AST parsing to extract symbol signatures and summaries. It enables users to search and retrieve specific code components while significantly reducing token consumption c
Azure DevOps MCP Server
★ 1.7kThis server provides a convenient API for interacting with Azure DevOps services, enabling AI assistants and other tools to manage work items, code repositories, boards, sprints, and more. Built with the Model Context Protocol, it provides a standard
GitHub Official
★ 1.2kOfficial GitHub integration with comprehensive API coverage
Azure DevOps
★ 367Enables interaction with Azure DevOps through Cursor chat, providing tools to manage builds, pipelines, work items, sprints, and board operations. Supports secure authentication via Personal Access Tokens and allows natural language-driven DevOps tas
Browse More Version Control MCP Servers
Explore all version control servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Bitbucket in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Bitbucket?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.