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
- 01List repositories and view details
- 02List and inspect pull requests
- 03Create pull requests
- 04Browse repository issues
- 05TypeScript support and input validation
Use cases
- 01Review repositories in a workspace
- 02Inspect or create pull requests
- 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.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEBitbucket 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
- Install dependencies:
npm install
- Set up authentication:
cp .env.example .env
# Edit .env with your Bitbucket credentials
- Build the project:
npm run build
- Run the server:
npm start
Authentication
Create a Bitbucket App Password:
- Go to https://bitbucket.org/account/settings/app-passwords/
- 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 workspacebitbucket_get_repository- Get repository details
Pull Request Management
bitbucket_list_pull_requests- List pull requestsbitbucket_get_pull_request- Get pull request detailsbitbucket_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:
- Open Cursor settings (Cmd/Ctrl + ,)
- Search for "MCP" or go to Extensions > MCP
- 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
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.