How to add Atlassian Bitbucket MCP Server to Cursor

Connect AI assistants to Bitbucket Cloud repositories, pull requests, and code via 6 generic API tools. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Atlassian Bitbucket MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Atlassian Bitbucket MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.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 Cursor?

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