Bitbucket

Provides MCP access to Bitbucket Cloud API, enabling 25+ tools for repositories, PRs, branches, commits, issues, pipelines, and code search.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "lexmata-bitbucket-mcp": {
      "command": "npx",
      "args": [
        "@lexmata/bitbucket-mcp"
      ],
      "env": {
        "BITBUCKET_CLIENT_ID": "your-client-id",
        "BITBUCKET_ACCESS_TOKEN": "your-access-token",
        "BITBUCKET_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

You can access Bitbucket Cloud data through a Model Context Protocol (MCP) server that exposes repositories, pull requests, branches, commits, issues, pipelines, and code search as reusable resources. This server authenticates securely and provides a suite of tools to interact with Bitbucket programmatically from your MCP-enabled client.

How to use

Run the MCP server in your environment and connect your MCP client to the local stdio server or to a running HTTP/MCP endpoint if you have one. You can perform actions such as listing repositories, creating pull requests, querying commits, and retrieving file contents through the available tools. Ensure you provide your Bitbucket access token or OAuth credentials as configured.

How to install

Prerequisites: Node.js 18+ and a preference for a modern package manager (npm, pnpm, or yarn). Install and run the MCP server using one of the supported approaches.

# Using npm
npm install -g @lexmata/bitbucket-mcp

# Using pnpm
pnpm add -g @lexmata/bitbucket-mcp

# Using yarn
yarn global add @lexmata/bitbucket-mcp

Additional notes

Configure your Bitbucket credentials either as a personal access token or via OAuth 2.0, then start the MCP server using the stdio approach shown below. The server name used in clients is bitbucket.

Available tools

list_repositories

List repositories in a workspace

get_repository

Get details of a specific repository

create_repository

Create a new repository

delete_repository

Delete a repository

list_repository_forks

List all forks of a repository

list_pull_requests

List pull requests with optional filtering

get_pull_request

Get details of a specific pull request

create_pull_request

Create a new pull request

update_pull_request

Update a pull request

merge_pull_request

Merge a pull request

decline_pull_request

Decline a pull request

approve_pull_request

Approve a pull request

request_changes

Request changes on a pull request

list_pr_comments

List comments on a pull request

add_pr_comment

Add a comment to a pull request

get_pr_diff

Get the diff for a pull request

list_branches

List branches in a repository

get_branch

Get details of a specific branch

create_branch

Create a new branch

delete_branch

Delete a branch

list_commits

List commits with optional filtering

get_commit

Get details of a specific commit

get_commit_diff

Get the diff for a commit

list_issues

List issues in a repository

get_issue

Get details of a specific issue

create_issue

Create a new issue

update_issue

Update an issue

delete_issue

Delete an issue

list_pipelines

List pipeline runs

get_pipeline

Get details of a pipeline run

trigger_pipeline

Trigger a new pipeline run

stop_pipeline

Stop a running pipeline

search_code

Search code across repositories

get_file_content

Get the content of a file

Built by

VeilStrat

AI signals for GTM teams