Set up Bitbucket MCP in Claude Desktop
Interact with Atlassian Bitbucket workspaces, repositories, pull requests, and code search through the Bitbucket API.
1
Locate the config file
Claude Desktop reads MCP server configuration from the following file:
~/Library/Application Support/Claude/claude_desktop_config.jsonCreate this file if it does not already exist.
2
Add the configuration
Add the following to your Claude Desktop config file:
json
{
"mcpServers": {
"bitbucket-mcp": {
"command": "npx",
"args": [
"-y",
"@aashari/mcp-server-atlassian-bitbucket"
],
"env": {
"ATLASSIAN_BITBUCKET_USERNAME": "YOUR_ATLASSIAN_BITBUCKET_USERNAME",
"ATLASSIAN_BITBUCKET_TOKEN": "YOUR_ATLASSIAN_BITBUCKET_TOKEN"
}
}
}
}3
Set up environment variables
Bitbucket MCP requires the following environment variables:
ATLASSIAN_BITBUCKET_USERNAMERequiredBitbucket username or email
ATLASSIAN_BITBUCKET_TOKENRequiredBitbucket app password or API token
4
Verify it works
Restart Claude Desktop. Bitbucket MCP should appear in your MCP server list with 10 tools available.
This server adds approximately 5,150 tokens to your context window for tool definitions.