What can you do with this server?

This MCP server integrates with Bitbucket Server/Data Center, enabling AI assistants to manage repositories, pull requests, code reviews, branches, commits, and more. * Repository Management: List projects and repositories, browse file structures, read file contents, edit files, create/delete repositories, upload attachments, get file blame, list/create forks, and get server info. * Pull Requests: Create (including cross-repo/fork PRs and drafts), get details, update, merge (multiple strategies), decline, list, and get activity, diffs, commits, and commits-to-PR mapping. Also list dashboard PRs across all repos. * Code Review: Manage PR comments (create, edit, delete, react; supports inline anchoring, draft state, tasks, threaded replies, resolve/unresolve) and reviews (approve, unapprove, publish). * Branches & Commits: List branches, create/delete branches (with default branch safety check), list commits, get commit details, compare refs, and list/create/delete/get tags. * Search & Insights: Search code and files across repos, get Code Insights reports and annotations (e.g., SonarQube), and get CI build statuses. * Users: Get user profiles and search users. * Labels: List, add, and remove repository labels. * Webhooks: List, create, update, and delete repository webhooks. * Commit Comments: List, create, edit, and delete comments on specific commits. * Repository Settings: Manage default reviewer conditions, branch restrictions, repository hooks (list/enable/disable/configure), merge checks, reviewer groups, and secret scanning allowlist rules. * SSH & GPG Keys: List, add, and delete SSH and GPG keys for the authenticated user. * Deployments: Get, create, and delete deployment records for commits. * Prompts & Resources: Built-in review-pr prompt for guided PR reviews; bitbucket://projects resource providing a cached list of accessible projects as ambient context.

Which integrations are available for this server?

Provides tools for interacting with Bitbucket Server (or Data Center) including repository management, pull request operations, code review, and branch/commit management.

How do I use bitbucket-server-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-server-mcp list my open pull requests" 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-server-mcp

by Upendrasengar

Overview Schema Related Servers Score Discussions

TypeScript

Remote

npm version npm downloads Bitbucket Server TypeScript Node License CodeQL

Quickstart

Install in VS Code Install in Cursor Install in LM Studio

Or via Claude Code:

claude mcp add bitbucket \
  -e BITBUCKET_URL=https://your-bitbucket-server.com \
  -e BITBUCKET_TOKEN=your-token \
  -- npx -y @upendra_sengar/bitbucket-server-mcp

Related MCP server: Atlassian Bitbucket MCP Server

Requirements

Bitbucket Server / Data Center 7.21+ (the E2E suite covers 7.21, 8.5, 8.9, 8.19, 9.4 and 10.2).
One of:
- Node.js >= 22.14 (via npx)
- Bun (via bunx)
- Docker

Installation

Add to your workspace .vscode/mcp.json:

{
  "servers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@upendra_sengar/bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token"
      }
    }
  }
}

These clients all use the same mcpServers format. Add the JSON below to the config file for your client:

Client	Config file
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
Cursor	`~/.cursor/mcp.json` (one-click install)
Windsurf	`~/.codeium/windsurf/mcp_config.json`
JetBrains	Settings > Tools > AI Assistant > MCP, or `~/.junie/mcp/mcp.json`
Neovim	mcphub.nvim `mcpservers.json`

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@upendra_sengar/bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token"
      }
    }
  }
}

Add to your Zed settings (~/.config/zed/settings.json on Linux, ~/Library/Application Support/Zed/settings.json on macOS):

{
  "context_servers": {
    "bitbucket": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@upendra_sengar/bitbucket-server-mcp"],
      "env": {
        "BITBUCKET_URL": "https://your-bitbucket-server.com",
        "BITBUCKET_TOKEN": "your-access-token"
      }
    }
  }
}

For environments without Node.js:

{
  "mcpServers": {
    "bitbucket": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "BITBUCKET_URL=https://your-bitbucket-server.com",
        "-e", "BITBUCKET_TOKEN=your-access-token",
        "ghcr.io/upendrasengar/bitbucket-server-mcp"
      ]
    }
  }
}

Or build locally: docker build -t bitbucket-mcp .

TIP

Bun users can replace npx -y with bunx in any of the configs above.

Tools

Repositories

Tool	Description
`list_projects`	List all accessible Bitbucket projects
`list_repositories`	List repositories in a project
`browse_repository`	Browse files and directories
`get_file_content`	Read file contents with pagination
`upload_attachment`	Upload a local file and get a markdown reference for PR comments
`edit_file`	Edit a file by committing a new version via the REST API
`get_server_info`	Get Bitbucket Server version and properties
`get_file_blame`	Get line-by-line blame/history for a file
`create_repository`	Create a new repository
`delete_repository`	Delete a repository (irreversible)

Pull Requests

Tool	Description
`create_pull_request`	Create a PR, including cross-repo from forks (`sourceProject`/`sourceRepository`) and drafts (`draft: true`). Auto-fetches default reviewers unless `includeDefaultReviewers: false`.
`get_pull_request`	Get PR details
`update_pull_request`	Safely update title, description, or reviewers (read-modify-write, preserves fields not explicitly changed)
`merge_pull_request`	Merge a PR with optional strategy (`no-ff`, `ff`, `ff-only`, `squash`, `rebase-no-ff`, `rebase-ff-only`, `squash-ff-only`)
`decline_pull_request`	Decline a PR
`list_pull_requests`	List PRs with filtering by state, author, direction
`list_dashboard_pull_requests`	List PRs across all repos for the authenticated user, filtered by role (`AUTHOR`/`REVIEWER`/`PARTICIPANT`), state, and review status
`get_pull_request_activity`	Get PR activity timeline, filtered by type (`all`, `reviews`, `comments`)
`get_diff`	Get PR diff with per-file truncation support. Use `stat: true` for a lightweight summary of changed files instead of the full diff.
`get_pull_request_commits`	List commits in a pull request
`get_commit_pull_requests`	List pull requests containing a specific commit

Code Review

Tool	Description
`manage_comment`	Unified create/edit/delete for PR comments. Supports inline anchoring (`filePath`/`line`/`lineType`), draft state (`state: PENDING`), task creation (`severity: BLOCKER`), threaded replies (`parentId`), and resolve/unresolve (`state: RESOLVED`/`OPEN`).
`manage_review`	Unified approve/unapprove/publish. Publish transitions all `PENDING` comments to visible and optionally sets `participantStatus` (`APPROVED`/`NEEDS_WORK`).

Branches & Commits

Tool	Description
`list_branches`	List branches with default branch detection
`list_commits`	Browse commit history with branch and author filtering
`manage_branches`	Create or delete branches (safety check prevents deleting default branch)
`get_commit`	Get details of a specific commit by its ID
`compare_refs`	List commits reachable from one ref but not another
`list_tags`	List tags in a repository
`manage_tags`	Create or delete tags
`get_tag`	Get details of a specific tag by its name

Search & Insights

Tool	Description
`search`	Search code and files across repositories
`get_code_insights`	Fetch Code Insights reports (SonarQube, security scans) and annotations
`get_build_status`	Get CI build status (state, name, URL) by commit ID or PR. When using prId, resolves the latest commit automatically.

Forks

Tool	Description
`list_forks`	List forks of a repository
`fork_repository`	Fork a repository into a target project

Users

Tool	Description
`get_user_profile`	Get a user profile by slug
`search_users`	Search users by filter query

Labels

Tool	Description
`list_labels`	List labels for a repository
`manage_labels`	Add or remove repository labels

Webhooks

Tool	Description
`list_webhooks`	List webhooks for a repository
`manage_webhooks`	Create, update, or delete webhooks

Commit Comments

Tool	Description
`list_commit_comments`	List comments on a specific commit
`manage_commit_comments`	Create, edit, or delete comments on a commit

Repository Settings

Tool	Description
`list_default_reviewer_conditions`	List default reviewer conditions
`list_branch_restrictions`	List branch permission restrictions
`list_repository_hooks`	List repository hooks and their status
`manage_repository_hooks`	Enable, disable, or configure repository hooks
`list_merge_checks`	List merge check configurations
`manage_merge_checks`	Configure merge check settings
`list_reviewer_groups`	List reviewer groups
`manage_reviewer_groups`	Create or delete reviewer groups
`list_secret_scanning_rules`	List secret scanning allowlist rules (8.5+)

Keys

Tool	Description
`list_ssh_keys`	List SSH keys for the authenticated user
`manage_ssh_keys`	Add or delete SSH keys
`list_gpg_keys`	List GPG keys for the authenticated user
`manage_gpg_keys`	Add or delete GPG keys

Prompts

Prompt	Description
`review-pr`	Step-by-step workflow for reviewing a PR: fetch details, read diff, check CI, create draft comments, and publish the review. Invoke via `/bitbucket:review-pr` in Claude Code. No arguments needed; the LLM asks for the PR interactively. You can add context, e.g. `/bitbucket:review-pr PR #42 in my-repo`.

Resources

Resource	URI	Description
`projects`	`bitbucket://projects`	Cached list of all accessible projects (5 min TTL). Useful as ambient context without explicit tool calls.

Configuration

Environment Variables

Variable	Required	Description
`BITBUCKET_URL`	Yes	Base URL of your Bitbucket Server instance
`BITBUCKET_TOKEN`	Yes*	Personal access token
`BITBUCKET_USERNAME`	Yes*	Username for basic auth
`BITBUCKET_PASSWORD`	Yes*	Password for basic auth
`BITBUCKET_DEFAULT_PROJECT`	No	Default project key when not specified in tool calls
`BITBUCKET_READ_ONLY`	No	Set to `true` to disable all write operations
`BITBUCKET_CUSTOM_HEADERS`	No	Extra headers for all requests (`Key=Value,Key2=Value2`). Useful for Zero Trust tokens.
`BITBUCKET_DIFF_MAX_LINES_PER_FILE`	No	Max lines per file in diffs. Set to `0` for no limit.
`BITBUCKET_CACHE_TTL`	No	Cache duration in seconds (default: 300). Set to `0` to disable caching.
`BITBUCKET_ENABLED_TOOLS`	No	Comma-separated list of tool names to enable. If not set, all tools are available.
`BITBUCKET_STARTUP_HEALTHCHECK`	No	Set to `true` to run a connectivity check against Bitbucket on startup (default: `false`).
`HTTPS_PROXY`	No	HTTP/HTTPS proxy URL (e.g. `http://proxy.corp.com:8080`). Useful in corporate environments.
`NODE_EXTRA_CA_CERTS`	No	Path to a PEM file with additional CA certificates. Use when Bitbucket is behind a self-signed TLS cert.

*Either BITBUCKET_TOKEN or both BITBUCKET_USERNAME and BITBUCKET_PASSWORD are required.

Token Permissions

The Personal Access Token needs the following Bitbucket permissions depending on what you intend to do:

Permission	Required for
Project read	`list_projects`, `list_repositories`, `browse_repository`, `get_file_content`
Repository read	All read tools (branches, commits, tags, diff, blame)
Repository write	`edit_file`, `manage_branches`, `manage_tags`, `create_repository`, `delete_repository`
Pull request read	`list_pull_requests`, `get_pull_request`, `get_diff`, `get_pull_request_commits`
Pull request write	`create_pull_request`, `update_pull_request`, `merge_pull_request`, `decline_pull_request`, `manage_comment`, `manage_review`

For a read-only setup, Project read + Repository read + Pull request read is sufficient.

Read-Only Mode

Set BITBUCKET_READ_ONLY=true to restrict the server to read-only operations. All create_*, update_*, delete_*, manage_*, merge_*, decline_*, fork_*, upload_*, and edit_* tools are disabled.

Tool Filtering

Set BITBUCKET_ENABLED_TOOLS to load only specific tools, reducing context window usage:

BITBUCKET_ENABLED_TOOLS=get_pull_request,get_diff,manage_comment,manage_review

Startup Healthcheck

When BITBUCKET_STARTUP_HEALTHCHECK=true, the server probes /rest/api/1.0/application-properties on startup and logs whether Bitbucket is reachable. If not, it logs a diagnostic line referencing the relevant env vars (BITBUCKET_URL, BITBUCKET_TOKEN, HTTPS_PROXY, NODE_EXTRA_CA_CERTS) without blocking the server. Useful for debugging connectivity issues before the first tool call fails with a generic error.

BITBUCKET_STARTUP_HEALTHCHECK=true

Response Curation

Read tools return compact responses by default, keeping only the fields an AI assistant typically needs. Every read tool accepts a fields parameter to customize:

Omit fields: returns a curated summary (e.g. PR id, title, state, author, branches, reviewers, task count)
fields: "*all": returns the complete raw Bitbucket API response
fields: "id,title,author.user.name": returns exactly those fields (dot notation for nested paths)

Caching

The server caches frequently accessed data in memory (project lists, repository metadata, default reviewers) to reduce API calls. The cache uses LRU eviction (max 500 entries) so memory stays bounded, and write operations automatically invalidate related entries.

By default, cached entries expire after 5 minutes. Configure with BITBUCKET_CACHE_TTL (in seconds), or set to 0 to disable caching entirely.

Bitbucket Cloud

This server targets Bitbucket Server / Data Center only. Bitbucket Cloud (bitbucket.org) uses a different REST API and is not supported.

Usage Examples

List open PRs assigned to you for review

list_dashboard_pull_requests with role=REVIEWER, state=OPEN

Create an inline draft comment on a PR

manage_comment with prId=42, filePath="src/auth.ts", line=17, lineType="ADDED",
text="This token is never invalidated — add expiry.", state="PENDING"

Then publish all draft comments at once:

manage_review with prId=42, action="publish", participantStatus="NEEDS_WORK"

Get a lightweight diff summary without reading every line

get_diff with prId=42, stat=true

Enable only the tools you need (reduces context window usage)

BITBUCKET_ENABLED_TOOLS=get_pull_request,get_diff,manage_comment,manage_review

Troubleshooting

UNABLE_TO_VERIFY_LEAF_SIGNATURE or self-signed certificate errors Set NODE_EXTRA_CA_CERTS=/path/to/your-ca-bundle.pem to point Node.js at your internal CA.

403 Forbidden on write operations Your token is missing a write-level permission. See the Token Permissions table above for the exact scope needed.

Server starts but can't reach Bitbucket Enable BITBUCKET_STARTUP_HEALTHCHECK=true — it will log a diagnostic line showing which env vars are missing or misconfigured. In corporate environments also set HTTPS_PROXY.

401 Unauthorized Token auth and basic auth are mutually exclusive. Set either BITBUCKET_TOKEN alone, or both BITBUCKET_USERNAME + BITBUCKET_PASSWORD. Having all three set will cause unpredictable behaviour — remove whichever pair you don't intend to use.

Tool not found / unexpected behaviour on older Bitbucket versions Some tools require Bitbucket 8.5+ (e.g. list_secret_scanning_rules). Check the tool description in the Tools section for version requirements. The E2E suite covers 7.21, 8.5, 8.9, 8.19, 9.4, and 10.2.

Contributing

See CONTRIBUTING.md for development setup, architecture overview, and how to add new tools.

License

Apache 2.0

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (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

Related MCP Servers

Bitbucket MCP Server
Version Control Developer Tools
Acendas
A
license
A
quality
D
maintenance
Enables management of Bitbucket Cloud pull requests through natural language, including creating, reviewing, approving, and commenting on PRs with automatic default reviewer support.
Last updated 2026-02-12
79
1
MIT
Atlassian Bitbucket MCP Server
Version Control Developer Tools
RajuSudhar
A
license
B
quality
D
maintenance
Enables AI assistants to interact with Bitbucket Cloud and self-hosted instances for pull request reviews, code search, repository operations, and managing PR comments and approvals.
Last updated 2026-05-15
19
GPL 3.0
Bitbucket MCP Server
Version Control Developer Tools
jlromano
A
license
B
quality
D
maintenance
Enables LLMs to interact with Bitbucket repositories to manage pull requests, branches, and commits through the Model Context Protocol. It supports repository operations such as searching code, accessing file contents, and comparing branches using natural language.
Last updated 2025-08-26
16
5,412
MIT
Bitbucket Server MCP
Version Control Developer Tools
evrimalacan
A
license
-
quality
D
maintenance
Connects AI assistants to Bitbucket Server/Data Center for reviewing pull requests, managing repositories, searching users, and more.
Last updated 2025-11-28
149
4
MIT

View all related MCP servers

Related MCP Connectors

Atlassian Rovo MCP Server
Connect to Atlassian Jira, Confluence, and Compass to search, create, and manage your work.
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Hint-Services-obsidian-github-mcp
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…

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

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

Quickstart

Requirements

Installation

Tools

Repositories

Pull Requests

Code Review

Branches & Commits

Search & Insights

Forks

Users

Labels

Webhooks

Commit Comments

Repository Settings

Keys

Prompts

Resources

Configuration

Environment Variables

Token Permissions

Read-Only Mode

Tool Filtering

Startup Healthcheck

Response Curation

Caching

Bitbucket Cloud

Usage Examples

List open PRs assigned to you for review

Create an inline draft comment on a PR

Get a lightweight diff summary without reading every line

Enable only the tools you need (reduces context window usage)

Troubleshooting

Contributing

License

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Bitbucket MCP Server

Atlassian Bitbucket MCP Server

Bitbucket MCP Server