Set up Bitbucket MCP in VS Code
Interact with Atlassian Bitbucket workspaces, repositories, pull requests, and code search through the Bitbucket API.
1
Locate the config file
VS Code reads MCP server configuration from the following file:
.vscode/settings.json → mcp sectionCreate this file if it does not already exist. For VS Code, this is inside your workspace .vscode/settings.json file under the mcp section.
2
Add the configuration
Add the following to your VS Code config file:
json
{
"servers": {
"bitbucket-mcp": {
"type": "stdio",
"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 VS Code. 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.