mcpField
B
Bitbucket MCP Server

Bitbucket MCP Server

Local
github.com/rafliruslanVersion Control0Updated 74w ago

About Bitbucket MCP Server

Bitbucket MCP Server connects MCP clients to Bitbucket repository, pull request, and issue operations. It provides tools for browsing repositories and issues and creating or inspecting pull requests.

Key features

  1. 01List repositories and view details
  2. 02List and inspect pull requests
  3. 03Create pull requests
  4. 04Browse repository issues
  5. 05TypeScript support and input validation

Use cases

  1. 01Review repositories in a workspace
  2. 02Inspect or create pull requests
  3. 03Browse issues in a repository

MCP support

Exposes Bitbucket repository, pull request, and issue operations as tools for MCP clients. Authentication uses Bitbucket credentials and an app password.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.