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

2. Set up authentication:

cp .env.example .env
# Edit .env with your Bitbucket credentials

3. Build the project:

npm run build

4. 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%Claudeclaude_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