How do I install the bitbucket mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `BITBUCKET_URL`, `BITBUCKET_WORKSPACE`, `BITBUCKET_USERNAME`, `BITBUCKET_PASSWORD`, `BITBUCKET_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Bitbucket MCP Server

Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration

Local serverstdioGo

What is the Bitbucket MCP Server?

Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration

What you get

A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs. This MCP server enables AI assistants like Cursor to interact with your Bitbucket repositories, pull requests, and other resources.

Checkout out the official npm package This server implements the Model Context Protocol standard to provide AI assistants with access to Bitbucket data and operations. It includes tools for:

Configuration and credentials

Node.js 18 or higher - npm or yarn

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
listRepositories
getRepository
getPullRequests
createPullRequest
getPullRequest
updatePullRequest
getPullRequestActivity
approvePullRequest
unapprovePullRequest
declinePullRequest
mergePullRequest
requestChanges
removeChangeRequest

How to install the Bitbucket MCP Server

{
  "mcpServers": {
    "bitbucket-1": {
      "command": "npx",
      "args": ["-y", "bitbucket-mcp"],
      "env": {
        "BITBUCKET_URL": "your-value",
        "BITBUCKET_WORKSPACE": "your-value",
        "BITBUCKET_USERNAME": "your-value",
        "BITBUCKET_PASSWORD": "your-value",
        "BITBUCKET_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Node.js 18 or higher - npm or yarn

Variable	Description	Required
BITBUCKET_URL	Endpoint or connection string the server talks to.	Yes
BITBUCKET_WORKSPACE	Configuration value read at startup.	Optional
BITBUCKET_USERNAME	Configuration value read at startup.	Optional
BITBUCKET_PASSWORD	Configuration value read at startup.	Optional
BITBUCKET_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use Bitbucket to Pagination.”
“Use Bitbucket to listRepositories.”
“Use Bitbucket to getRepository.”

Frequently asked questions

Model Context Protocol (MCP) server for Bitbucket Cloud and Server API integration Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.