Which integrations are available for this server?

Provides tools for managing Bitbucket Cloud repositories, pull requests, issues, pipelines, and more via the Bitbucket Cloud REST API.

How do I use Bitbucket Cloud MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Bitbucket Cloud MCP Server Show open pull requests in my Bitbucket repository" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Bitbucket Cloud MCP Server

by or2ooo

Overview Schema Related Servers Score Discussions

TypeScript

Remote

Bitbucket Cloud MCP Server

npm License: MIT

A Model Context Protocol (MCP) server for the Bitbucket Cloud REST API v2.0. Works with any MCP client — Claude Code, GitHub Copilot, OpenAI Codex, and more. Provides 32 tools across 5 toolsets with safety controls and compact LLM-optimized output.

Setup

Prerequisites

Node.js v24+
Atlassian API token (see below)

Create an API Token

Go to Atlassian API Tokens
Click "Create API token with scopes"
Name the token (e.g., "Bitbucket MCP") and set expiration
Select app: Bitbucket
Enable the scopes listed below
Click Create and copy the token

Read-only scopes (6 scopes — sufficient when using BITBUCKET_READONLY=true):

Scope	Enables
`read:user:bitbucket`	`bb_whoami`
`read:workspace:bitbucket`	`bb_list_workspaces`
`read:repository:bitbucket`	`bb_list_repositories`, `bb_get_repository`, `bb_list_branches`, `bb_list_commits`, `bb_get_file`, `bb_list_directory`, `bb_search_code`
`read:pullrequest:bitbucket`	`bb_list_pull_requests`, `bb_get_pull_request`, `bb_get_pull_request_diff`, `bb_get_pull_request_diffstat`, `bb_list_pull_request_activity`
`read:issue:bitbucket`	`bb_list_issues`, `bb_get_issue`
`read:pipeline:bitbucket`	`bb_list_pipelines`, `bb_get_pipeline`

Write scopes (add these 4 for full access):

Scope	Enables
`write:repository:bitbucket`	`bb_create_commit_files`, `bb_create_branch`, `bb_delete_branch`
`write:pullrequest:bitbucket`	`bb_create_pull_request`, `bb_update_pull_request`, `bb_add_pull_request_comment`, `bb_approve_pull_request`, `bb_request_changes_pull_request`, `bb_merge_pull_request`, `bb_decline_pull_request`
`write:issue:bitbucket`	`bb_create_issue`, `bb_comment_issue`
`write:pipeline:bitbucket`	`bb_trigger_pipeline`

Add to Your MCP Client

One command — no clone or build needed:

claude mcp add bitbucket \
  -e ATLASSIAN_USER_EMAIL=your-email@example.com \
  -e ATLASSIAN_API_TOKEN=your-api-token \
  -e BITBUCKET_READONLY=false \
  -- npx -y @or2ooo/bitbucket-mcp@latest

Verify with:

claude mcp list

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "bitbucket": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@or2ooo/bitbucket-mcp@latest"],
      "env": {
        "ATLASSIAN_USER_EMAIL": "your-email@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token",
        "BITBUCKET_READONLY": "false"
      }
    }
  }
}

Add to ~/.codex/config.toml:

[mcp_servers.bitbucket]
command = "npx"
args = ["-y", "@or2ooo/bitbucket-mcp@latest"]
env = { ATLASSIAN_USER_EMAIL = "your-email@example.com", ATLASSIAN_API_TOKEN = "your-api-token", BITBUCKET_READONLY = "false" }

git clone https://github.com/or2ooo/bitbucket-mcp.git
cd bitbucket-mcp
npm install && npm run build

claude mcp add bitbucket \
  -e ATLASSIAN_USER_EMAIL=your-email@example.com \
  -e ATLASSIAN_API_TOKEN=your-api-token \
  -e BITBUCKET_READONLY=true \
  -- node $(pwd)/dist/index.js

Related MCP server: Bitbucket MCP Server

Environment Variables

Variable	Required	Description
`ATLASSIAN_USER_EMAIL`	Yes	Atlassian account email
`ATLASSIAN_API_TOKEN`	Yes	Atlassian API token (see Create an API Token)
`BITBUCKET_DEFAULT_WORKSPACE`	No	Default workspace slug
`BITBUCKET_ALLOWED_WORKSPACES`	No	Comma-separated allowlist of workspace slugs
`BITBUCKET_ALLOWED_REPOS`	No	Comma-separated allowlist (`slug` or `workspace/slug`)
`BITBUCKET_READONLY`	No	`true` to block all write operations
`BITBUCKET_BASE_URL`	No	Override API base URL

Safety Controls

Readonly mode: Set BITBUCKET_READONLY=true to prevent any write operations.
Workspace allowlist: Restrict access to specific workspaces.
Repository allowlist: Restrict access to specific repositories.
Destructive action confirmation: Merge PR, decline PR, and delete branch tools require explicit confirm: true.

Tool Reference

Context (2 tools)

Tool	Description
`bb_whoami`	Get current authenticated user
`bb_list_workspaces`	List accessible workspaces

Repositories (10 tools)

Tool	Description
`bb_list_repositories`	List repositories in a workspace
`bb_get_repository`	Get repository details
`bb_list_branches`	List branches
`bb_list_commits`	List commits (optionally for a branch/tag)
`bb_get_file`	Get file content at a specific revision
`bb_create_commit_files`	Create a commit with file changes (write)
`bb_create_branch`	Create a new branch (write)
`bb_delete_branch`	Delete a branch (destructive, requires confirm)
`bb_list_directory`	List directory contents at a specific revision
`bb_search_code`	Search for code in a workspace or repository

Pull Requests (12 tools)

Tool	Description
`bb_list_pull_requests`	List PRs with optional state filter
`bb_get_pull_request`	Get PR details
`bb_create_pull_request`	Create a new PR (write)
`bb_update_pull_request`	Update PR title, description, or reviewers (write)
`bb_get_pull_request_diff`	Get PR diff (raw text)
`bb_get_pull_request_diffstat`	Get PR diffstat summary
`bb_list_pull_request_activity`	List PR activity (comments, approvals, updates)
`bb_add_pull_request_comment`	Add a comment to a PR (write)
`bb_approve_pull_request`	Approve a PR (write)
`bb_request_changes_pull_request`	Request changes on a PR (write)
`bb_merge_pull_request`	Merge a PR (destructive, requires confirm)
`bb_decline_pull_request`	Decline a PR (destructive, requires confirm)

Issues (4 tools)

Tool	Description
`bb_list_issues`	List issues with optional query
`bb_get_issue`	Get issue details
`bb_create_issue`	Create a new issue (write)
`bb_comment_issue`	Add a comment to an issue (write)

Pipelines (3 tools)

Tool	Description
`bb_list_pipelines`	List recent pipelines
`bb_get_pipeline`	Get pipeline details
`bb_trigger_pipeline`	Trigger a pipeline run (write)

Development

npm test         # Run tests
npm run lint     # Lint
npm run build    # Compile

Contributing

See CONTRIBUTING.md for development setup and guidelines.

Security

See SECURITY.md for reporting vulnerabilities.

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

1wRelease cycle

5Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/or2ooo/bitbucket-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server