Bitbucket
About
Integrates with Bitbucket's REST APIs to enable repository management, pull request handling, and workspace operations with TypeScript-based error handling and pagination support
Details
- Author
- aashari
- Repository
- aashari/mcp-server-atlassian-bitbucket
- GitHub stars
- 14
- Downloads
- 5,828
- Categories
- Design, Workplace, Developer Tools, AI, API, Infrastructure, Frontend
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
BitbucketCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@aashari/mcp-server-atlassian-bitbucket
Environment-
ATLASSIAN_API_TOKEN
your_scoped_api_token -
ATLASSIAN_USER_EMAIL
your.email@company.com
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Get up and running in 2 minutes:
Create ~/.mcp/configs.json for system-wide configuration:
Option 1: Scoped API Token (recommended - future-proof)
{
"bitbucket": {
"environments": {
"ATLASSIAN_USER_EMAIL": "your.email@company.com",
"ATLASSIAN_API_TOKEN": "your_scoped_api_token",
"BITBUCKET_DEFAULT_WORKSPACE": "your_main_workspace"
}
}
}
Option 2: Legacy App Password (will be deprecated June 2026)
{
"bitbucket": {
"environments": {
"ATLASSIAN_BITBUCKET_USERNAME": "your_username",
"ATLASSIAN_BITBUCKET_APP_PASSWORD": "your_app_password",
"BITBUCKET_DEFAULT_WORKSPACE": "your_main_workspace"
}
}
}
Alternative config keys: The system also accepts "atlassian-bitbucket", "@aashari/mcp-server-atlassian-bitbucket", or "mcp-server-atlassian-bitbucket" instead of "bitbucket".
bb_get
GET any Bitbucket API endpoint (read data). Parameters: path (string), queryParams (optional JSON), jq (optional string), outputFormat (optional string)
bb_post
POST to any endpoint (create resources). Parameters: path (string), body (JSON), queryParams (optional JSON), jq (optional string), outputFormat (optional string)
bb_put
PUT to any endpoint (replace resources). Parameters: path (string), body (JSON), queryParams (optional JSON), jq (optional string), outputFormat (optional string)
bb_patch
PATCH any endpoint (partial updates). Parameters: path (string), body (JSON), queryParams (optional JSON), jq (optional string), outputFormat (optional string)
bb_delete
DELETE any endpoint (remove resources). Parameters: path (string), queryParams (optional JSON), jq (optional string), outputFormat (optional string)
bb_clone
Clone a repository locally. Parameters: workspaceSlug (optional string), repoSlug (string), targetPath (string)
This MCP server provides 6 generic tools that can access any Bitbucket API endpoint:
| Tool | Description | Parameters |
|------|-------------|------------|
| bb_get | GET any Bitbucket API endpoint (read data) | path, queryParams?, jq?, outputFormat? |
| bb_post | POST to any endpoint (create resources) | path, body, queryParams?, jq?, outputFormat? |
| bb_put | PUT to any endpoint (replace resources) | path, body, queryParams?, jq?, outputFormat? |
| bb_patch | PATCH any endpoint (partial updates) | path, body, queryParams?, jq?, outputFormat? |
| bb_delete | DELETE any endpoint (remove resources) | path, queryParams?, jq?, outputFormat? |
| bb_clone | Clone a repository locally | workspaceSlug?, repoSlug, targetPath |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"bitbucket": {
"env": {
"ATLASSIAN_API_TOKEN": "your_scoped_api_token",
"ATLASSIAN_USER_EMAIL": "your.email@company.com"
},
"args": [
"-y",
"@aashari/mcp-server-atlassian-bitbucket"
],
"command": "npx"
}
}
}Linux
{
"env": {
"ATLASSIAN_API_TOKEN": "your_scoped_api_token",
"ATLASSIAN_USER_EMAIL": "your.email@company.com"
},
"args": [
"-y",
"@aashari/mcp-server-atlassian-bitbucket"
],
"command": "npx"
}Macos
{
"env": {
"ATLASSIAN_API_TOKEN": "your_scoped_api_token",
"ATLASSIAN_USER_EMAIL": "your.email@company.com"
},
"args": [
"-y",
"@aashari/mcp-server-atlassian-bitbucket"
],
"command": "npx"
}Windows
{
"env": {
"ATLASSIAN_BITBUCKET_USERNAME": "your_username",
"ATLASSIAN_BITBUCKET_APP_PASSWORD": "your_app_password"
},
"args": [
"/c",
"npx",
"-y",
"@aashari/mcp-server-atlassian-bitbucket"
],
"command": "cmd"
}Connect AI to Your Bitbucket Repositories
Transform how you work with Bitbucket by connecting Claude, Cursor AI, and other AI assistants directly to your repositories, pull requests, and code. Get instant insights, automate code reviews, and streamline your development workflow.
What You Can Do
- Ask AI about your code: "What's the latest commit in my main repository?"
- Get PR insights: "Show me all open pull requests that need review"
- Search your codebase: "Find all JavaScript files that use the authentication function"
- Review code changes: "Compare the differences between my feature branch and main"
- Manage pull requests: "Create a PR for my new-feature branch"
- Automate workflows: "Add a comment to PR #123 with the test results"
Perfect For
- Developers who want AI assistance with code reviews and repository management
- Team Leads needing quick insights into project status and pull request activity
- DevOps Engineers automating repository workflows and branch management
- Anyone who wants to interact with Bitbucket using natural language
Requirements
- Node.js 18.0.0 or higher
- Bitbucket Cloud account (not Bitbucket Server/Data Center)
- Authentication credentials: Scoped API Token (recommended) or App Password (legacy)
Quick Start
Get up and running in 2 minutes:
1. Get Your Bitbucket Credentials
> IMPORTANT: Bitbucket App Passwords are being deprecated and will be removed by June 2026. We recommend using Scoped API Tokens for new setups.
Option A: Scoped API Token (Recommended - Future-Proof)
Bitbucket is deprecating app passwords. Use the new scoped API tokens instead:
1. Go to Atlassian API Tokens
2. Click "Create API token with scopes"
3. Select "Bitbucket" as the product
4. Choose the appropriate scopes:
- For read-only access: repository, workspace
- For full functionality: repository, workspace, pullrequest
5. Copy the generated token (starts with ATATT)
6. Use with your Atlassian email as the username
Option B: App Password (Legacy - Will be deprecated)
Generate a Bitbucket App Password (legacy method):
1. Go to Bitbucket App Passwords
2. Click "Create app password"
3. Give it a name like "AI Assistant"
4. Select these permissions:
- Workspaces: Read
- Repositories: Read (and Write if you want AI to create PRs/comments)
- Pull Requests: Read (and Write for PR management)
2. Try It Instantly
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
