How to add Atlassian Bitbucket MCP Server to Windsurf

Connect AI assistants to Bitbucket Cloud repositories, pull requests, and code via 6 generic API tools. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 156★ · stdio · apikey

Windsurf config for Atlassian Bitbucket MCP Server

npm install -g @aashari/mcp-server-atlassian-bitbucket

{
  "mcpServers": {
    "atlassian-bitbucket-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-bitbucket"
      ],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Atlassian Bitbucket MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Atlassian Bitbucket MCP Server's tools become available to Cascade.

Before you start

Node.js 18.0.0 or higher
Bitbucket Cloud account (not Bitbucket Server/Data Center)
Scoped API Token (recommended) or legacy App Password with appropriate scopes/permissions

What Atlassian Bitbucket MCP Server can do in Windsurf

bb_get

GET any Bitbucket API endpoint to read data. Parameters: path, queryParams?, jq?, outputFormat?.

bb_post

POST to any endpoint to create resources (e.g., create a PR or add a comment). Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_put

PUT to any endpoint to replace resources. Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_patch

PATCH any endpoint for partial updates (e.g., update a PR title). Parameters: path, body, queryParams?, jq?, outputFormat?.

bb_delete

DELETE any endpoint to remove resources (e.g., delete a branch or remove PR approval). Parameters: path, queryParams?, jq?, outputFormat?.

bb_clone

Clone a repository locally. Parameters: workspaceSlug? (uses default if omitted), repoSlug, targetPath (absolute path to parent directory).

Security

Runs entirely on your local machine and uses your own Bitbucket credentials; never sends data to third parties. Requires a Bitbucket Cloud Scoped API Token (recommended) or legacy App Password — App Passwords are being deprecated and removed by June 2026, so prefer scoped API tokens. Grant only the scopes you need: 'repository' and 'workspace' for read-only, plus 'pullrequest' for PR management. Bitbucket Cloud only (not Server/Data Center).

Atlassian Bitbucket MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Atlassian Bitbucket MCP Server config there under the "mcpServers" key and restart the client.

Is Atlassian Bitbucket MCP Server safe to use with Windsurf?

What permissions or scopes do I need?

For Scoped API Tokens (recommended): 'repository' and 'workspace' scopes, plus 'pullrequest' for PR management. For legacy App Passwords: Workspaces Read, Repositories Read, Pull Requests Read for read-only; add Write permissions for repositories and pull requests for full functionality.

Does it work with private repositories?

Yes. It works with both public and private repositories, as long as your credentials have the appropriate permissions.

Which AI assistants are supported?

Any MCP-compatible client, including Claude Desktop (official support), Cursor AI, Continue.dev, and Cline.

View repo Full Atlassian Bitbucket MCP Server page