Set up Bitbucket MCP in Windsurf

Interact with Atlassian Bitbucket workspaces, repositories, pull requests, and code search through the Bitbucket API.

Locate the config file

Windsurf reads MCP server configuration from the following file:

~/.codeium/windsurf/mcp_config.json

Create this file if it does not already exist.

Add the configuration

Add the following to your Windsurf 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"
      }
    }
  }
}

Set up environment variables

Bitbucket MCP requires the following environment variables:

ATLASSIAN_BITBUCKET_USERNAMERequired

Bitbucket username or email

ATLASSIAN_BITBUCKET_TOKENRequired

Bitbucket app password or API token

Verify it works

Restart Windsurf. 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.

Set up Bitbucket MCP in other editors

Claude Code Cursor VS Code Claude Desktop Continue

← Back to Bitbucket MCP