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:

What the assistant can call

Once Bitbucket is connected, these are the calls the assistant has available:

  • Pagination — Unless noted otherwise, listing tools accept the following optional parameters:
  • listRepositories — The listRepositories tool exposed by this server
  • getRepository — The getRepository tool exposed by this server
  • getPullRequests — The getPullRequests tool exposed by this server
  • createPullRequest — The createPullRequest tool exposed by this server
  • getPullRequest — The getPullRequest tool exposed by this server
  • updatePullRequest — The updatePullRequest tool exposed by this server
  • getPullRequestActivity — The getPullRequestActivity tool exposed by this server
  • approvePullRequest — The approvePullRequest tool exposed by this server
  • unapprovePullRequest — The unapprovePullRequest tool exposed by this server
  • declinePullRequest — The declinePullRequest tool exposed by this server
  • mergePullRequest — The mergePullRequest tool exposed by this server

Configuration and credentials

  • Node.js 18 or higher - npm or yarn

Recorded tools

  • listRepositories — The listRepositories tool exposed by this server.
  • getRepository — The getRepository tool exposed by this server.
  • getPullRequests — The getPullRequests tool exposed by this server.
  • createPullRequest — The createPullRequest tool exposed by this server.
  • getPullRequest — The getPullRequest tool exposed by this server.
  • updatePullRequest — The updatePullRequest tool exposed by this server.
  • getPullRequestActivity — The getPullRequestActivity tool exposed by this server.
  • approvePullRequest — The approvePullRequest tool exposed by this server.
  • unapprovePullRequest — The unapprovePullRequest tool exposed by this server.
  • declinePullRequest — The declinePullRequest tool exposed by this server.
  • mergePullRequest — The mergePullRequest tool exposed by this server.
  • requestChanges — The requestChanges tool exposed by this server.
  • removeChangeRequest — The removeChangeRequest tool exposed by this server.

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.

ToolWhat it does
listRepositoriesThe listRepositories tool exposed by this server.
getRepositoryThe getRepository tool exposed by this server.
getPullRequestsThe getPullRequests tool exposed by this server.
createPullRequestThe createPullRequest tool exposed by this server.
getPullRequestThe getPullRequest tool exposed by this server.
updatePullRequestThe updatePullRequest tool exposed by this server.
getPullRequestActivityThe getPullRequestActivity tool exposed by this server.
approvePullRequestThe approvePullRequest tool exposed by this server.
unapprovePullRequestThe unapprovePullRequest tool exposed by this server.
declinePullRequestThe declinePullRequest tool exposed by this server.
mergePullRequestThe mergePullRequest tool exposed by this server.
requestChangesThe requestChanges tool exposed by this server.
removeChangeRequestThe removeChangeRequest tool exposed by this server.

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
VariableDescriptionRequired
BITBUCKET_URLEndpoint or connection string the server talks to.Yes
BITBUCKET_WORKSPACEConfiguration value read at startup.Optional
BITBUCKET_USERNAMEConfiguration value read at startup.Optional
BITBUCKET_PASSWORDConfiguration value read at startup.Optional
BITBUCKET_TOKENCredential 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.