What can you do with this server?

The Bitbucket MCP server is a Model Context Protocol interface that enables AI assistants to fully manage Bitbucket Cloud resources: * Workspaces – List workspaces, get details, list projects, and list members. * Repositories – List, get, create, delete, and fork repositories; retrieve file contents and browse source listings. * Pull Requests – List, get, create, update, merge, approve, unapprove, and decline PRs; manage comments (including inline); retrieve diffs. * Branches & Tags – List, get, create, and delete branches and tags. * Commits – List commits, get commit details, and retrieve diffs or diffstats between refs. * Pipelines (CI/CD) – List, get, trigger (including custom), and stop pipelines; inspect steps and logs; configure pipeline enablement; manage pipeline variables (list, get, create, update, delete). * Issues – List, get, create, update, and delete issues; manage comments; vote/unvote and watch/unwatch. * Webhooks – Full CRUD management of repository-level and workspace-level webhooks (URLs, events, secrets, active status). * Output Formats – All tools support json (full), toon (~50% token savings), and compact (~76% token savings) formats. * Authentication – Supports API token, app password (basic auth), and OAuth.

Which integrations are available for this server?

Enables management of Bitbucket Cloud repositories, pull requests, branches, commits, pipelines, issues, and webhooks. Supports workspace and project operations, code reviews, CI/CD pipeline triggers, and issue tracking.

How do I use Bitbucket MCP?

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 MCP list open pull requests in the frontend 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.

de en es ja ko ru zh

Bitbucket MCP

by icy-r

Overview Schema Related Servers Score Discussions

TypeScript

Remote

Bitbucket MCP

npm version License: MIT

A Model Context Protocol (MCP) server for Bitbucket Cloud. Enables AI assistants to manage repositories, pull requests, pipelines, and more.

Installation

Option 1: Using npx (Recommended)

No installation required. Run directly:

npx @icy-r/bitbucket-mcp

Option 2: Global Installation

npm install -g @icy-r/bitbucket-mcp
bitbucket-mcp

Option 3: Local Development

git clone https://github.com/icy-r/bitbucket-mcp.git
cd bitbucket-mcp
pnpm install
pnpm build
node dist/index.js

MCP Client Configuration

Cursor IDE

Add to your Cursor MCP settings (~/.cursor/mcp.json on Windows: %USERPROFILE%\.cursor\mcp.json):

Using npx (Recommended):

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@icy-r/bitbucket-mcp"],
      "env": {
        "BITBUCKET_AUTH_METHOD": "api_token",
        "BITBUCKET_USER_EMAIL": "your.email@example.com",
        "BITBUCKET_API_TOKEN": "your_api_token"
      }
    }
  }
}

Using local build:

{
  "mcpServers": {
    "bitbucket": {
      "command": "node",
      "args": ["D:\\path\\to\\bitbucket-mcp\\dist\\index.js"],
      "env": {
        "BITBUCKET_AUTH_METHOD": "api_token",
        "BITBUCKET_USER_EMAIL": "your.email@example.com",
        "BITBUCKET_API_TOKEN": "your_api_token"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@icy-r/bitbucket-mcp"],
      "env": {
        "BITBUCKET_AUTH_METHOD": "api_token",
        "BITBUCKET_USER_EMAIL": "your.email@example.com",
        "BITBUCKET_API_TOKEN": "your_api_token"
      }
    }
  }
}

Other MCP Clients

The server follows the MCP standard and works with any compatible client. Use the configuration pattern above, adjusting paths as needed for your platform.

Authentication

API Token (Recommended)

Go to Bitbucket API Tokens
Create a new token with the required permissions
Set the environment variables:

BITBUCKET_AUTH_METHOD=api_token
BITBUCKET_USER_EMAIL=your.email@example.com
BITBUCKET_API_TOKEN=your_api_token

App Password

Go to Bitbucket App Passwords
Create a new app password with required permissions
Use basic auth method with your username and app password

Environment Variables

Variable	Description	Required
`BITBUCKET_AUTH_METHOD`	`api_token`, `oauth`, `basic`	Yes
`BITBUCKET_USER_EMAIL`	Your Atlassian email	For api_token
`BITBUCKET_API_TOKEN`	API token	For api_token
`BITBUCKET_USERNAME`	Bitbucket username	For basic auth
`BITBUCKET_APP_PASSWORD`	App password	For basic auth
`BITBUCKET_WORKSPACE`	Default workspace (used when tool call omits `workspace`)	No
`BITBUCKET_OUTPUT_FORMAT`	`json`, `toon`, `compact`	No

Available Tools

Tool	Actions
`bitbucket_workspaces`	list, get, list_projects, list_members
`bitbucket_repositories`	list, get, create, delete, fork, get_file, list_source
`bitbucket_pull_requests`	list, get, create, update, merge, approve, unapprove, decline, list_comments, add_comment, get_diff
`bitbucket_branches`	list_branches, get_branch, create_branch, delete_branch, list_tags, get_tag, create_tag
`bitbucket_commits`	list, get, get_diff, get_diffstat
`bitbucket_pipelines`	list, get, trigger, trigger_custom, stop, list_steps, get_step, get_logs, get_config, set_enabled, list_variables, get_variable, create_variable, update_variable, delete_variable
`bitbucket_issues`	list, get, create, update, delete, list_comments, add_comment, vote, unvote, watch, unwatch
`bitbucket_webhooks`	list, get, create, update, delete, list_workspace, get_workspace, create_workspace, update_workspace, delete_workspace

Output Formats

Control response verbosity with the format parameter:

Format	Description	Token Savings
`json`	Full JSON output	0%
`toon`	Compact TOON format	~50%
`compact`	Essential fields only	~76%

Example usage:

{ "action": "list", "workspace": "my-workspace", "format": "compact" }

Examples

List repositories in a workspace

{
  "action": "list",
  "workspace": "my-workspace"
}

Create a pull request

{
  "action": "create",
  "workspace": "my-workspace",
  "repo_slug": "my-repo",
  "title": "Feature: Add new functionality",
  "source_branch": "feature/new-feature",
  "destination_branch": "main"
}

Trigger a pipeline

{
  "action": "trigger",
  "workspace": "my-workspace",
  "repo_slug": "my-repo",
  "branch_name": "main"
}

Default workspace

Set BITBUCKET_WORKSPACE in your environment to skip the workspace parameter on every tool call:

{ "action": "list", "repo_slug": "my-repo" }

Development

# Clone the repository
git clone https://github.com/icy-r/bitbucket-mcp.git
cd bitbucket-mcp

# Install dependencies
pnpm install

# Build
pnpm build

# Run tests
pnpm test

# Run in development mode (watch)
pnpm dev

# Lint and format
pnpm lint
pnpm format

Requirements

Node.js >= 20.0.0
pnpm (for development)

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

3wRelease cycle

2Releases (12mo)

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Tools

Appeared in Searches

A server for finding information about Bitbucket, the Git repository hosting service

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

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/icy-r/bitbucket-mcp'

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