bitbucket-mcp-server

rafliruslan/bitbucket-mcp-server

3.2

If you are the rightful owner of bitbucket-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server that integrates with the Bitbucket API for managing repositories, pull requests, and issues.

Bitbucket MCP Server

A Model Context Protocol (MCP) server that provides integration with Bitbucket API for repositories, pull requests, and issues management.

Features

  • List and get repository details
  • Manage pull requests (list, get details, create)
  • Browse issues
  • Full TypeScript support
  • Error handling and validation

Setup

  1. Install dependencies:
npm install
  1. Set up authentication:
cp .env.example .env
# Edit .env with your Bitbucket credentials
  1. Build the project:
npm run build
  1. Run the server:
npm start

Authentication

Create a Bitbucket App Password:

  1. Go to https://bitbucket.org/account/settings/app-passwords/
  2. Create a new app password with required permissions:
    • Repositories: Read, Write
    • Pull requests: Read, Write
    • Issues: Read, Write

Available Tools

Repository Management

  • bitbucket_list_repositories - List repositories in a workspace
  • bitbucket_get_repository - Get repository details

Pull Request Management

  • bitbucket_list_pull_requests - List pull requests
  • bitbucket_get_pull_request - Get pull request details
  • bitbucket_create_pull_request - Create a new pull request

Issue Management

  • bitbucket_list_issues - List repository issues

MCP Configuration

Claude Desktop

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["/path/to/bitbucket-mcp-server/build/index.js"],
      "env": {
        "BITBUCKET_USERNAME": "your-username",
        "BITBUCKET_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Cursor IDE

Add this to your Cursor settings:

  1. Open Cursor settings (Cmd/Ctrl + ,)
  2. Search for "MCP" or go to Extensions > MCP
  3. Add a new server configuration:
{
  "name": "bitbucket",
  "command": "node",
  "args": ["/path/to/bitbucket-mcp-server/build/index.js"],
  "env": {
    "BITBUCKET_USERNAME": "your-username",
    "BITBUCKET_APP_PASSWORD": "your-app-password"
  }
}

Development

# Development mode with auto-reload
npm run dev

# Type checking
npm run typecheck

# Linting
npm run lint