Bitbucket Cloud MCP Server
mustaqeemtariq/bitbucket-cloud-mcp-server
Integre Bitbucket Cloud com Claude e ferramentas MCP
Ver no GitHubServidor MCP que conecta clientes AI compatíveis ao Bitbucket Cloud, permitindo gerenciamento completo de repositórios, pull requests, commits e reviews. Fornece acesso programático a operações como listar, criar, atualizar, aprovar e fazer merge de PRs diretamente pela IA.
Instalação
npx convez-ai mustaqeemtariq/bitbucket-cloud-mcp-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar revisão de pull requests com IA
- Gerenciar repositórios e branches remotamente
- Integrar Bitbucket em workflows de agentes de IA
Veredito

MCP server bem estruturado para integração Bitbucket-Claude com suporte completo a PRs e repositórios. Requer credenciais Bitbucket configuradas e é ideal para times que centralizam fluxo de código no Bitbucket.
README
A tradução para o português deste README ainda está na fila.
Bitbucket Cloud MCP Server
A Model Context Protocol (MCP) server that lets MCP-compatible AI clients work with Bitbucket Cloud repositories, pull requests, commits, comments, approvals, and merges.
Features
- List repositories in a Bitbucket workspace
- List, inspect, create, update, approve, merge, and comment on pull requests
- Fetch pull request metadata, commits, comments, and diff content for reviews
- List repository commits
- Read-only annotations on safe exploration tools
- Runs over MCP stdio for clients such as Claude Desktop, Cursor, Kiro, and MCP Inspector
Requirements
- Node.js 18 or newer
- A Bitbucket Cloud workspace
- A Bitbucket API token or app password with repository and pull request access
Installation
Run without installing:
npx bitbucket-cloud-mcp-server
Or install globally:
npm install -g bitbucket-cloud-mcp-server
bitbucket-cloud-mcp-server
Configuration
Set these environment variables in your MCP client configuration:
| Variable | Description |
|---|---|
BITBUCKET_WORKSPACE | Bitbucket workspace slug |
BITBUCKET_EMAIL | Atlassian account email |
BITBUCKET_TOKEN | Bitbucket API token or app password |
Example:
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "bitbucket-cloud-mcp-server"],
"env": {
"BITBUCKET_WORKSPACE": "my-workspace",
"BITBUCKET_EMAIL": "my-email@example.com",
"BITBUCKET_TOKEN": "my-api-token"
}
}
}
}
If you installed the package globally, you can use the binary directly:
{
"mcpServers": {
"bitbucket": {
"command": "bitbucket-cloud-mcp-server",
"env": {
"BITBUCKET_WORKSPACE": "my-workspace",
"BITBUCKET_EMAIL": "my-email@example.com",
"BITBUCKET_TOKEN": "my-api-token"
}
}
}
}
Verify Credentials
Before running the MCP server, verify Bitbucket access:
curl -u "my-email@example.com:my-api-token" \
"https://api.bitbucket.org/2.0/repositories/my-workspace"
A successful response returns repository information for the workspace.
Tools
list_repositories
Lists repositories in the configured workspace.
Input:
{
"includePrivate": true
}
list_pull_requests
Lists pull requests for a repository.
Input:
{
"repo": "my-repository"
}
get_pull_request
Gets pull request details.
Input:
{
"repo": "my-repository",
"id": 123
}
review_pull_request
Returns pull request metadata, commits, existing comments, and diff content for review.
Input:
{
"repo": "my-repository",
"id": 123
}
create_pull_request
Creates a pull request.
Input:
{
"repo": "my-repository",
"title": "Add authentication",
"source": "feature/auth",
"destination": "main",
"description": "Adds login functionality"
}
update_pull_request
Updates an existing pull request's title, description, destination branch, or reviewers. All fields are optional — only provided fields are updated.
Input:
{
"repo": "my-repository",
"id": 123,
"title": "Updated title",
"description": "Updated description",
"destination": "develop",
"reviewers": ["{user-uuid-1}", "{user-uuid-2}"]
}
approve_pull_request
Approves a pull request.
Input:
{
"repo": "my-repository",
"id": 123
}
Bitbucket may prevent users from approving their own pull requests depending on repository settings.
merge_pull_request
Merges a pull request.
Input:
{
"repo": "my-repository",
"id": 123
}
comment_pull_request
Adds a comment to a pull request. Optionally provide filePath and line to make it an inline comment on a specific line in the diff.
General comment:
{
"repo": "my-repository",
"id": 123,
"comment": "Looks good to me."
}
Inline comment on a specific file and line:
{
"repo": "my-repository",
"id": 123,
"comment": "Consider renaming this variable.",
"filePath": "src/index.ts",
"line": 42
}
request_changes
Requests changes on a pull request, signaling the author needs to address feedback.
Input:
{
"repo": "my-repository",
"id": 123
}
list_commits
Lists commits for a repository.
Input:
{
"repo": "my-repository"
}
Development
Install dependencies:
npm install
Run in development mode:
npm run dev
Build:
npm run build
Preview the npm package contents:
npm run pack:dry-run
Publishing
The unscoped bitbucket-mcp package name is already used on npm, so this package is configured as bitbucket-cloud-mcp-server.
Before publishing, confirm you are logged in:
npm whoami
Then publish:
npm publish --access public
The prepublishOnly script rebuilds dist before publishing.
License
ISC