Bitbucket

Bitbucket MCP is a server that lets Cursor IDE connect to Bitbucket Cloud to fetch workspace data, repository details, commit histories, pull requests, and project configurations. It enables you to explore your Bitbucket environment from Cursor, automate common data retrieval tasks, and manage repository governance directly from your development workflow.

How to use

You connect to the Bitbucket MCP server through Cursor by defining an MCP server that points at the Bitbucket integration and provides authentication details. Once configured, you gain access to a set of tools that let you list workspaces, enumerate repositories, inspect repositories and commits, manage pull requests, view projects, and adjust branch restrictions. Use the tools to gather data for reporting, automation, or integration workflows.

How to install

Prerequisites you need before installing include Node.js 18 or higher and npm or yarn. You also need a Bitbucket Cloud account and a Bitbucket App Password for authentication.

# 1) Install dependencies
npm install

# 2) Build the project
npm run build

# 3) Create an API token in Bitbucket (or reuse an existing one from Jira/Confluence)
# Follow Bitbucket steps to generate a token with appropriate permissions (Repositories: Read)
```} ,{

Configure environment and run the MCP server

Create a file named .env at the project root and populate it with your Bitbucket credentials and workspace name.

BITBUCKET_USERNAME=your_bitbucket_email_address
BITBUCKET_APP_PASSWORD=your_api_token
BITBUCKET_WORKSPACE=your_workspace_name
```} ,{

Add the MCP configuration to Cursor

Add the following MCP server configuration to your Cursor setup to enable the Bitbucket MCP integration.

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["@korfu/bitbucket-mcp"],
      "env": {
        "BITBUCKET_USERNAME": "your_bitbucket_email_address",
        "BITBUCKET_APP_PASSWORD": "your_api_token",
        "BITBUCKET_WORKSPACE": "your_workspace_name"
      }
    }
  }
}
```}]} ,{

Restart Cursor

After adding the configuration, restart Cursor IDE to load the MCP server.

Available tools

list_workspaces

Lists all workspaces accessible by the current user.

list_repositories

Lists all repositories in the configured Bitbucket workspace.

get_repository_details

Get detailed information about a specific repository including latest commit info.

list_commits

Get commit information for a specific repository.

get_commit

Get a single commit by its hash.

list_pull_requests

List all pull requests in a repository.

get_pull_request

Get a single pull request by its ID.

create_pull_request

Create a new pull request (Beta version - untested).

update_pull_request

Update an existing pull request (Beta version - untested).

get_project

Get a single project by its key.

list_default_reviewers

List default reviewers for a project.

list_branch_restrictions

List all branch restrictions for a repository.

get_branch_restriction

Get a single branch restriction by its ID.

update_repository_branching_model_settings

Update the branching model configuration for a repository (Beta version - untested).

update_project_branching_model_settings

Update the branching model configuration for a project (Beta version - untested).