bitbucket
Provides tools for interacting with Bitbucket Cloud REST API, enabling management of pull requests, pipelines, logs, and repository cloning.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-bitbucket
An MCP server (stdio) for the Bitbucket Cloud REST API 2.0. Works with Cursor: pull requests, pipelines, logs, clone.
The tools are consistent with the typical bb_get / bb_post / bb_put / bb_patch / bb_delete / bb_clone set.
Requirements
Node.js 18+
Scoped Atlassian API Token (App Passwords don't work)
Token: id.atlassian.com → API tokens.
Useful scopes: repository, pull request, pipeline, and user read (read:repository:bitbucket, read:pullrequest:bitbucket, read:pipeline:bitbucket, read:user:bitbucket). For write, add the corresponding write:*.
Related MCP server: bitbucket-mcp
Installation
git clone https://github.com/genkis/mcp-bitbucket.git
cd mcp-bitbucket
npm installCopy .env.example to .env and fill in the values locally. Do not commit the .env file.
Cursor (~/.cursor/mcp.json)
Keep the token and email only in the local Cursor configuration, not in this repository.
{
"mcpServers": {
"bitbucket": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/mcp-bitbucket/index.js"],
"env": {
"ATLASSIAN_USER_EMAIL": "you@example.com",
"ATLASSIAN_API_TOKEN": "your-scoped-api-token",
"BITBUCKET_DEFAULT_WORKSPACE": "your-workspace-slug"
}
}
}
}After making changes, reload the MCP servers in Cursor.
Variables:
Variable | Description |
| Atlassian account email |
| Scoped API Token |
| Default workspace (used by |
Aliases: BITBUCKET_USERNAME, BITBUCKET_API_TOKEN.
Tools
The /2.0 prefix is added automatically. The path starts with /, e.g. /workspaces.
Tool | Purpose |
| Read (PRs, pipelines, logs, files) |
| Create (PR, comment, merge) |
| Full resource replacement |
| Partial update |
| Delete / decline PR |
|
|
Common parameters: path, optionally queryParams, jq (JMESPath), outputFormat (toon or json). bb_post / bb_put / bb_patch require body.
Example paths:
/workspaces/repositories/{workspace}/{repo}/pullrequests/{id}/repositories/{workspace}/{repo}/pullrequests/{id}/diff/repositories/{workspace}/{repo}/pipelines/?pagelen=50&sort=-created_on/repositories/{workspace}/{repo}/pipelines/{uuid}/steps/{stepUuid}/log
It's worth applying the jq filter whenever dealing with lists, to avoid pulling the entire JSON into the model.
Security
Do not commit tokens,
.env, ormcp.jsonwith secrets.This server only forwards requests to
api.bitbucket.orgwith Basic Auth (email + token).Logs and errors do not print the token.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage Pipefork API projects, drafts, connections, secrets, and deployments through MCP.
Unofficial GitLab MCP — wraps the GitLab REST API v4 (BYO API key)
Unofficial Confluence MCP — wraps the Confluence Cloud REST API v2 (OAuth)
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Related MCP Servers
- FlicenseBqualityCmaintenanceEnables interaction with a Bitbucket Server/Data Center instance, exposing its REST v1.0 API as MCP tools to manage projects, repositories, branches, pull requests, comments, diffs, commits, files, search, and build status.41-
- AlicenseAqualityCmaintenanceEnables MCP clients to browse and interact with Bitbucket Cloud, exposing workspace, repository, branch, and pull request operations as tools.1810 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Bitbucket workspaces, repositories, branches, commits, and pull requests through MCP tools for listing, retrieving, commenting, searching, and managing version control workflows. It supports generic GET, POST, PUT, PATCH, DELETE, and clone operations against Bitbucket Cloud REST API endpoints.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Bitbucket Cloud workspaces, repositories, pull requests, commits, branches, diffs, comments, issues, pipelines, and deployments through MCP tools for listing, reading, creating, updating, deleting, searching, commenting, and cloning via the Bitbucket API.MIT