What can you do with this server?

The mcp-server-bitbucket is a comprehensive Model Context Protocol (MCP) server providing complete Bitbucket API integration for managing repositories, code, and CI/CD workflows through Claude, Cursor, or any MCP-compatible client. Core Capabilities: * Repository Management: Create, read, update, delete, and list repositories with filtering by project, fuzzy name search, or advanced query syntax; update visibility, description, name, and move between projects. * Pull Request Workflow: Create, merge, approve, unapprove, decline, and request changes; list by state (OPEN/MERGED/DECLINED); view diffs; add general or inline comments; support for merge commit, squash, and fast-forward strategies. * CI/CD Pipeline Management: Trigger, monitor, stop, and view logs for pipeline runs; manage environment variables (create, read, update, delete, including secured values); get and create commit build statuses. * Branch & Commit Operations: List and get details for branches and commits with filtering by branch or file path; compare commits/branches; create branch restrictions (require approvals, prevent force push). * Version Control: Create, list, and delete tags; compare commits or branches to see file changes. * Source Code Browsing: Read file contents and list directory structures without cloning repositories. * Deployment Management: List and get details for deployment environments (test, staging, production); track deployment history. * Project Organization: List projects, get project details, and move repositories between projects. * Access Control: Manage user and group permissions (read, write, admin) for repositories. * Webhook Integration: Create, list, get, and delete webhooks for repository events (push, PR actions, comments, etc.). * Advanced Features: 58 total tools providing comprehensive API coverage; MCP resources for browsable workspace data; reusable MCP prompts for code review, release notes, pipeline debugging, and repo summaries; available in TypeScript and Python.

Which integrations are available for this server?

Provides comprehensive Bitbucket API operations including repository management, pull request workflows, pipeline orchestration, branch and tag management, commit tracking, deployment monitoring, webhook configuration, file browsing, and permissions management.

How do I use mcp-server-bitbucket?

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., "@mcp-server-bitbucket list recent pull requests for my-project 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.

mcp-server-bitbucket

by JaviMaligno

Overview Schema Related Servers Score Discussions

Python

Hybrid

Bitbucket MCP Server

CI/CD PyPI version npm version License: MIT

MCP server for Bitbucket API operations. Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Language Versions

This repository contains both TypeScript and Python implementations:

Version	Directory	Status	Installation
TypeScript	`/typescript`	✅ Recommended (Smithery)	`npm install -g mcp-server-bitbucket`
Python	`/python`	✅ Stable	`pipx install mcp-server-bitbucket`

Note: The TypeScript version is used for Smithery deployments. Both versions provide identical functionality.

Related MCP server: Bitbucket Server MCP

Features

Repositories: get, create, delete, list, update (move to project, rename)
Pull Requests: create, get, list, merge, approve, decline, request changes, comments, diff
Pipelines: trigger, get status, list, view logs, stop
Branches: list, get
Projects: list, get
Commits: list, get details, compare/diff between branches
Commit Statuses: get build statuses, create status (CI/CD integration)
Deployments: list environments, get environment details, deployment history
Webhooks: list, create, get, delete
Tags: list, create, delete
Branch Restrictions: list, create, delete branch protection rules
Source Browsing: read files, list directories without cloning
Repository Permissions: manage user and group permissions
Pipeline Variables: manage CI/CD environment variables
MCP Prompts: reusable workflow templates (code review, release notes, etc.)
MCP Resources: browsable workspace data

Quick Start

TypeScript (Recommended for Smithery)

# Install globally
npm install -g mcp-server-bitbucket

# Or run directly with npx
npx mcp-server-bitbucket

Python

# Install with pipx
pipx install mcp-server-bitbucket

# Configure Claude Code
claude mcp add bitbucket -s user \
  -e BITBUCKET_WORKSPACE=your-workspace \
  -e BITBUCKET_EMAIL=your-email@example.com \
  -e BITBUCKET_API_TOKEN=your-api-token \
  -- mcp-server-bitbucket

Full Installation Guide - Includes API token creation, permissions setup, and troubleshooting.

Configuration

Environment Variables

Variable	Required	Description
`BITBUCKET_WORKSPACE`	✅	Bitbucket workspace slug
`BITBUCKET_EMAIL`	✅	Account email for Basic Auth
`BITBUCKET_API_TOKEN`	✅	Repository access token
`API_TIMEOUT`		Request timeout in seconds (default: 30)
`MAX_RETRIES`		Max retry attempts for rate limiting (default: 3)

Claude Code CLI

# TypeScript version
claude mcp add bitbucket -s user \
  -e BITBUCKET_WORKSPACE=your-workspace \
  -e BITBUCKET_EMAIL=your-email@example.com \
  -e BITBUCKET_API_TOKEN=your-api-token \
  -- npx mcp-server-bitbucket

# Python version
claude mcp add bitbucket -s user \
  -e BITBUCKET_WORKSPACE=your-workspace \
  -e BITBUCKET_EMAIL=your-email@example.com \
  -e BITBUCKET_API_TOKEN=your-api-token \
  -- mcp-server-bitbucket

Cursor IDE

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["mcp-server-bitbucket"],
      "env": {
        "BITBUCKET_WORKSPACE": "your-workspace",
        "BITBUCKET_EMAIL": "your-email@example.com",
        "BITBUCKET_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools (58 total)

Repositories

Tool	Description
`list_repositories`	List and search repositories
`get_repository`	Get repository details
`create_repository`	Create a new repository
`delete_repository`	Delete a repository
`update_repository`	Update repo settings

Pull Requests

Tool	Description
`list_pull_requests`	List PRs
`get_pull_request`	Get PR details
`create_pull_request`	Create a new PR
`merge_pull_request`	Merge a PR
`approve_pr`	Approve a PR
`unapprove_pr`	Remove approval
`request_changes_pr`	Request changes
`decline_pr`	Decline a PR
`list_pr_comments`	List comments
`add_pr_comment`	Add comment
`get_pr_diff`	Get the diff

Pipelines

Tool	Description
`list_pipelines`	List recent runs
`get_pipeline`	Get status
`get_pipeline_logs`	View logs
`trigger_pipeline`	Trigger a run (supports custom pipelines and commit triggers)
`stop_pipeline`	Stop pipeline
`list_pipeline_variables`	List variables
`get_pipeline_variable`	Get variable
`create_pipeline_variable`	Create variable
`update_pipeline_variable`	Update variable
`delete_pipeline_variable`	Delete variable

trigger_pipeline Parameters

Parameter	Type	Description
`repo_slug`	string	Repository slug (required)
`branch`	string	Branch to run on (default: main). Mutually exclusive with `commit`
`commit`	string	Commit hash to run on. Mutually exclusive with `branch`
`custom_pipeline`	string	Name from `custom:` section in bitbucket-pipelines.yml
`variables`	array	Variables as `[{key, value, secured?}]`

Examples:

# Default pipeline on main
trigger_pipeline(repo_slug="my-repo")

# Custom pipeline
trigger_pipeline(repo_slug="my-repo", custom_pipeline="deploy-staging")

# Custom pipeline on specific commit with variables
trigger_pipeline(
    repo_slug="my-repo",
    commit="abc123def",
    custom_pipeline="deploy-prod",
    variables=[
        {"key": "ENV", "value": "production"},
        {"key": "SECRET", "value": "xxx", "secured": True}
    ]
)

Branches, Commits, Tags

Tool	Description
`list_branches`	List branches
`get_branch`	Get branch details
`list_commits`	List commits
`get_commit`	Get commit details
`compare_commits`	Compare branches
`get_commit_statuses`	Get build statuses
`create_commit_status`	Report CI status
`list_tags`	List tags
`create_tag`	Create a tag
`delete_tag`	Delete a tag

And more...

Deployments: list_environments, get_environment, list_deployment_history
Webhooks: list_webhooks, create_webhook, get_webhook, delete_webhook
Branch Restrictions: list_branch_restrictions, create_branch_restriction, delete_branch_restriction
Source Browsing: get_file_content, list_directory
Permissions: User and group permission management (8 tools)
Projects: list_projects, get_project

MCP Prompts

Reusable workflow templates:

Prompt	Description
`code_review`	Comprehensive PR code review
`release_notes`	Generate changelog between versions
`pipeline_debug`	Debug failed CI/CD pipelines
`repo_summary`	Complete repository status overview

MCP Resources

Browsable workspace data:

Resource URI	Description
`bitbucket://repositories`	List all repos
`bitbucket://repositories/{repo}`	Repository details
`bitbucket://repositories/{repo}/branches`	Branch list
`bitbucket://repositories/{repo}/pull-requests`	Open PRs
`bitbucket://projects`	List all projects

Development

TypeScript

cd typescript
npm install
npm run build
npm run dev  # Watch mode

Python

cd python
uv sync
uv run python -m src.server

Creating a Bitbucket API Token

Go to your repository in Bitbucket
Navigate to Repository settings > Access tokens
Click Create Repository Access Token
Select permissions:
- Repository: Read, Write, Admin, Delete
- Pull requests: Read, Write
- Pipelines: Read, Write
Copy the token immediately

Author

Built by Javier Aguilar - AI Agent Architect specializing in multi-agent orchestration and MCP development.

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

0dRelease cycle

2Releases (12mo)

Commit activity

Resources

GitHub Repository

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

Related MCP Servers

Bitbucket MCP Server
Version Control Developer Tools
zhanglc
A
license
B
quality
D
maintenance
An MCP server that provides tools for interacting with the Bitbucket API, supporting both Bitbucket Cloud and Bitbucket Server, enabling pull request, branch, file, code review, and search operations.
Updated a year ago (2025-08-20 16:25 UTC)
19
4,628
MIT
Bitbucket Server MCP
Version Control Developer Tools
ManpreetShuann
A
license
B
quality
C
maintenance
An MCP server for Atlassian Bitbucket Server / Data Center, providing 66 tools for managing projects, repositories, branches, files, commits, pull requests, and code search with opt-in deletion operations.
Updated 5 months ago (2026-03-23 09:46 UTC)
57
1
MIT
Bitbucket Cloud MCP Server
Version Control CI/CD & DevOps
or2ooo
A
license
B
quality
C
maintenance
MCP server for the Bitbucket Cloud REST API v2.0, providing 32 tools across 5 toolsets for repository management, pull requests, issues, pipelines, and more with safety controls and LLM-optimized output.
Updated 5 months ago (2026-03-22 08:00 UTC)
33
18
2
MIT
bitbucket-mcp
Version Control Developer Tools
odesh009
A
license
-
quality
D
maintenance
A comprehensive MCP server for Bitbucket integration, providing 27 tools to manage repositories, pull requests, branches, commits, issues, and workspaces.
Updated 7 months ago (2026-01-05 16:44 UTC)
MIT

View all related MCP servers

Related MCP Connectors

neverinfamous-memory-journal-mcp
A MCP server built for developers enabling Git based project management with project and personal…
GitLab MCP Server
Go MCP server for GitLab: 2 dynamic tools reach 1000+ REST/GraphQL actions. Free/CE, no paid tier.
DATPAQ
34 production API tools over one hosted MCP endpoint.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
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

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/JaviMaligno/mcp-server-bitbucket'

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

Bitbucket MCP Server

Language Versions

Features

Quick Start

TypeScript (Recommended for Smithery)

Python

Configuration

Environment Variables

Claude Code CLI

Cursor IDE

Available Tools (58 total)

Repositories

Pull Requests

Pipelines

trigger_pipeline Parameters

Branches, Commits, Tags

And more...

MCP Prompts

MCP Resources

Development

TypeScript

Python

Creating a Bitbucket API Token

Author

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Bitbucket MCP Server

Bitbucket Server MCP

Bitbucket Cloud MCP Server

bitbucket-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API