Bitbucket MCP Server

What is Bitbucket MCP Server?

An MCP server that integrates with the Bitbucket API to manage repositories, pull requests, and issues. It is designed for developers using MCP clients like Claude Desktop or Cursor IDE who need programmatic access to Bitbucket resources.

How to use Bitbucket MCP Server?

Install dependencies with npm install, set up authentication by copying .env.example to .env and editing with your Bitbucket credentials, build with npm run build, then run with npm start. Configure the server in your MCP client (Claude Desktop or Cursor IDE) by providing the path to the built index.js and environment variables BITBUCKET_USERNAME and BITBUCKET_APP_PASSWORD.

Key features of Bitbucket MCP Server

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

Use cases of Bitbucket MCP Server

• Automate pull request review workflows via a chat interface
• Query repository information and issue lists without leaving your editor
• Create new pull requests directly from an MCP client
• Integrate Bitbucket management into AI‑assisted development tools

FAQ from Bitbucket MCP Server

What authentication is required?

A Bitbucket App Password with permissions for Repositories (Read, Write), Pull requests (Read, Write), and Issues (Read, Write). Set it along with your Bitbucket username in the environment variables BITBUCKET_USERNAME and BITBUCKET_APP_PASSWORD.

What tools does Bitbucket MCP Server provide?

Repository management: bitbucket_list_repositories, bitbucket_get_repository. Pull request management: bitbucket_list_pull_requests, bitbucket_get_pull_request, bitbucket_create_pull_request. Issue management: bitbucket_list_issues.

How do I configure Bitbucket MCP Server for Claude Desktop?

Add a mcpServers entry in the Claude Desktop configuration file. On macOS the file is at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows at %APPDATA%\Claude\claude_desktop_config.json. Set the command to node, args to ["/path/to/bitbucket-mcp-server/build/index.js"], and env with your Bitbucket credentials.

How do I configure Bitbucket MCP Server for Cursor IDE?

Open Cursor settings (Cmd/Ctrl + ,), go to Extensions > MCP, and add a new server configuration with the same node command, build path, and environment variables as used for Claude Desktop.

What development scripts are available?

Use npm run dev for development mode with auto‑reload, npm run typecheck for TypeScript checking, and npm run lint for linting.