Bitbucket

Provides an MCP server to manage Bitbucket Cloud resources via AI-assisted workflows using API tokens or app passwords.

typescript

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 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": {
    "icy-r-bitbucket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icy-r/bitbucket-mcp"
      ],
      "env": {
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_API_TOKEN": "abcd1234...",
        "BITBUCKET_WORKSPACE": "my-workspace",
        "BITBUCKET_USER_EMAIL": "user@example.com",
        "BITBUCKET_AUTH_METHOD": "api_token",
        "BITBUCKET_APP_PASSWORD": "app-password",
        "BITBUCKET_OUTPUT_FORMAT": "compact"
      }
    }
  }
}

You have a Bitbucket MCP Server that lets AI assistants interact with Bitbucket Cloud to manage repositories, pull requests, pipelines, and related workspace activities. It exposes a consistent programmatic interface so you can automate common Bitbucket tasks from your preferred MCP clients.

How to use

You connect an MCP client to the Bitbucket MCP Server using the environment and command patterns shown below. Once connected, you can ask the MCP to list workspaces and repositories, view or create pull requests, trigger pipelines, manage branches, and interact with issues, webhooks, and more. Use the MCP client’s normal command surface to request actions such as listing resources, creating items, updating status, or retrieving diffs and logs. Ensure your authentication method is configured correctly (API token, OAuth, or basic) and that your client is pointed at the Bitbucket MCP Server you are running or accessing.

What you can accomplish with Bitbucket MCP

Inspect Bitbucket workspaces, projects, and repository structures to understand your codebases.
Create and manage pull requests, including updating titles, branches, and status.
Trigger and monitor pipelines, view logs, and inspect configuration.
Work with branches, tags, commits, and repository metadata to automate common development workflows.

Authentication reminders

Choose an authentication method that fits your workflow. You can use an API token, an app password, or basic authentication. Ensure the corresponding environment variables are set for the MCP client you use.

Starting and using with a client

To begin, configure a client with the proper environment variables, then start the MCP integration. If you’re running a local instance, start the server process and point your client to it. If you prefer remote operation, use a compatible http-based MCP endpoint configured for the Bitbucket MCP Server.

Available tools

bitbucket_workspaces

List workspaces, get workspace details, list projects, and list workspace members.

bitbucket_repositories

List repositories, get repository details, create, delete, fork, get file content, and list source.

bitbucket_pull_requests

List, get, create, update, merge, approve, unapprove, decline pull requests and manage comments and diffs.

bitbucket_branches

List branches, get branch details, create branches, delete branches, list tags, get and create tags.

bitbucket_commits

List commits, get commit details, and view diffs.

bitbucket_pipelines

List, get, trigger pipelines, stop pipelines, manage steps, logs, config, and variables.

bitbucket_issues

List, get, create, update, delete issues, and manage comments, votes, and watches.

bitbucket_webhooks

List, get, create, update, delete webhooks and manage workspace-related webhooks.

Built by

VeilStrat

AI signals for GTM teams