bitbucket-mcp

Overview

The Bitbucket MCP server provides comprehensive integration with Bitbucket Cloud and Server APIs through the Model Context Protocol. It offers tools for managing repositories, pull requests, and related resources with proper authentication and safety features. The server is designed to be safe by default, avoiding DELETE operations to prevent data loss while allowing controlled enablement of dangerous operations when needed.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• listRepositories

  Lists repositories in a workspace

  Try:List all repositories in my workspaceTry:Show me repositories with 'api' in the name
• getRepository

  Gets details for a specific repository

  Try:Get details for the 'billing-api' repositoryTry:Show information about my main project repository
• getPullRequests

  Gets pull requests for a repository

  Try:Show all open pull requests in my repositoryTry:List all merged pull requests for the billing project
• createPullRequest

  Creates a new pull request

  Try:Create a pull request from feature branch to main with title 'Add new endpoint'Try:Make a draft PR for the authentication changes
• getPullRequest

  Gets details for a specific pull request

  Try:Show details for pull request 123Try:Get information about the authentication PR
• updatePullRequest

  Updates a pull request

  Try:Update PR 123 with a new descriptionTry:Change the title of the billing PR to 'Monthly billing updates'
• getPullRequestActivity

  Gets the activity log for a pull request

  Try:Show all activity on pull request 45Try:What's the recent activity on the API changes PR?
• approvePullRequest

  Approves a pull request

  Try:Approve pull request 123Try:I approve the billing changes PR
• mergePullRequest

  Merges a pull request

  Try:Merge pull request 123 with message 'Fixes issue #456'Try:Squash and merge the authentication PR
• addPullRequestComment

  Creates a comment on a pull request

  Try:Add a comment to PR 123 about the new endpointTry:Comment on line 15 of the billing changes PR
• createDraftPullRequest

  Creates a new draft pull request

  Try:Create a draft PR for the database changesTry:Make a new draft pull request for the billing updates
• publishDraftPullRequest

  Publishes a draft pull request to make it ready for review

  Try:Publish draft PR 123 for reviewTry:Make the authentication draft PR ready for review

Comparable tools

Installation

BITBUCKET_URL="https://api.bitbucket.org/2.0" \
BITBUCKET_WORKSPACE="your-workspace" \
BITBUCKET_USERNAME="your-username" \
BITBUCKET_PASSWORD="your-app-password" \
npx -y bitbucket-mcp@latest

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "bitbucket-mcp@latest"],
      "env": {
        "BITBUCKET_URL": "https://api.bitbucket.org/2.0",
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_PASSWORD": "your-app-password"
      }
    }
  }
}

FAQ

How do I authenticate with Bitbucket?

You can authenticate using either username/app password or an access token. For username/password, create an App Password with 'Repositories: Read' and 'Pull requests: Read, Write' permissions.

Does this MCP support Bitbucket Server?

Yes, this MCP server supports both Bitbucket Cloud and Server. For Server, set BITBUCKET_URL to your self-hosted instance URL.

Compare bitbucket-mcp with