mcp-server-atlassian-bitbucket

Overview

This TypeScript-based MCP server enables AI systems like Claude, Cursor, and other assistants to interact with Bitbucket repositories and pull requests through standardized tools. It supports all Bitbucket Cloud API operations including listing workspaces, repositories, branches, commits, and managing pull requests. The server features an optimized TOON output format to reduce token consumption by 30-60% and supports both legacy App Passwords and modern Scoped API Tokens for authentication.

Try asking AI

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

• bb_get

  GET any Bitbucket API endpoint (read data)

  Try:List all repositories in my main workspaceTry:Show me details about the backend-api repositoryTry:Get the commit history for the feature-auth branch
• bb_post

  POST to any endpoint (create resources)

  Try:Create a pull request from feature-login to main branchTry:Create a new issue in the bug-tracker repository
• bb_put

  PUT to any endpoint (replace resources)

  Try:Update pull request #42 with new title and descriptionTry:Replace the contents of the configuration file
• bb_patch

  PATCH any endpoint (partial updates)

  Try:Add a comment to PR #15 saying the tests passedTry:Update only the description of an issue
• bb_delete

  DELETE any endpoint (remove resources)

  Try:Delete pull request #33Try:Remove the feature-auth branch from the repository
• bb_clone

  Clone a repository locally

  Try:Clone the frontend repository to my local machineTry:Clone backend-api repository to /projects/backend

Comparable tools

Installation

# Scoped API Token (recommended)
export ATLASSIAN_USER_EMAIL="your.email@company.com"
export ATLASSIAN_API_TOKEN="your_scoped_api_token"

# OR Legacy App Password (deprecated)
export ATLASSIAN_BITBUCKET_USERNAME="your_username"
export ATLASSIAN_BITBUCKET_APP_PASSWORD="your_app_password"

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_scoped_api_token"
      }
    }
  }
}

FAQ

Is this server compatible with Bitbucket Server/Data Center?

No, this server is designed for Bitbucket Cloud only. It does not support Bitbucket Server or Data Center.

What authentication methods are supported?

The server supports both legacy App Passwords (deprecated June 2026) and modern Scoped API Tokens. Scoped API Tokens are recommended for new setups.

How can I reduce token consumption when using this server?

Use the built-in TOON output format (default, reduces tokens by 30-60%) and always apply JMESPath filtering to extract only the needed data from API responses.

Compare mcp-server-atlassian-bitbucket with