Log inSubmit server
MCP Server Atlassian Bitbucket logo

MCP Server Atlassian Bitbucket

by aashari

Connects MCP-compatible AI clients to Bitbucket Cloud for repository, pull request, code, and workspace operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Server Atlassian Bitbucket

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "aashari-mcp-server-atlassian-bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-bitbucket"
      ],
      "env": {
        "ATLASSIAN_USER_EMAIL": "YOUR_VALUE_HERE",
        "ATLASSIAN_API_TOKEN": "YOUR_VALUE_HERE",
        "ATLASSIAN_BITBUCKET_USERNAME": "YOUR_VALUE_HERE",
        "ATLASSIAN_BITBUCKET_APP_PASSWORD": "YOUR_VALUE_HERE",
        "BITBUCKET_DEFAULT_WORKSPACE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 6 tools correctly (1mo ago).

Overview

The aashari/mcp-server-atlassian-bitbucket MCP server exposes Bitbucket Cloud REST operations through six MCP tools for reading, creating, updating, deleting, and cloning repository data. It adds the Bitbucket API’s `/2.0` prefix automatically and supports TOON or JSON output, query parameters, and response filtering with `jq`. Use the aashari/mcp-server-atlassian-bitbucket MCP server when an agent needs to inspect code, manage pull requests, work with branches, or retrieve workspace and repository information. It requires Node.js 18 or later and Bitbucket Cloud credentials, using either a scoped API token or a legacy app password.

Use cases

  • Inspect repository metadata, branches, commits, and source files
  • Review pull-request details, comments, and diffs
  • Create, update, approve, merge, or decline pull requests
  • Compare branches or commits through Bitbucket endpoints
  • Clone a repository to a local filesystem path

Key features

  • Generic Bitbucket Cloud REST access
  • Pull-request creation and management
  • Repository, branch, commit, and source inspection
  • TOON or JSON response output
  • Response filtering with jq expressions
  • SSH-preferred repository cloning

Tools6

What MCP Server Atlassian Bitbucket lets your agent do. Expand a tool for its parameters.

Verified live~3.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/21 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @aashari/mcp-server-atlassian-bitbucket (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars163Stargazers on the source repository.
npm downloads14kPackage downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Server Atlassian Bitbucket works

What aashari/mcp-server-atlassian-bitbucket MCP server does

The aashari/mcp-server-atlassian-bitbucket MCP server gives MCP-compatible assistants access to Bitbucket Cloud repositories, workspaces, branches, commits, source files, pull requests, comments, and diffs. Rather than exposing separate tools for every Bitbucket resource, it provides generic operations mapped to HTTP methods: bb_get, bb_post, bb_put, bb_patch, and bb_delete. A sixth tool, bb_clone, copies a repository to a local filesystem location.

The API tools can read any Bitbucket Cloud endpoint supported by the server and can create or modify resources when the supplied Bitbucket credentials have the required permissions. Examples include creating or merging a pull request, adding or editing comments, approving a pull request, changing repository metadata, managing branch restrictions, and deleting resources. Destructive operations such as deleting a repository are available, so client-side safeguards may be appropriate.

How it works

Each API request takes a path beginning with /; the server adds the Bitbucket REST API /2.0 prefix automatically. Optional query parameters include pagination, filtering, sorting, and sparse field selection. Responses use TOON by default, with JSON available through the outputFormat parameter.

The jq parameter filters or reshapes returned data before it is sent to the client. The provided guidance recommends using it on normal requests because unfiltered Bitbucket responses can contain substantial metadata. For unfamiliar endpoints, first retrieve one item without a filter to inspect its shape, then add a focused expression for later calls. Pagination can also be limited with pagelen, such as requesting a single workspace while discovering the schema.

The bb_clone operation accepts a repository slug and absolute target path. It prefers SSH when configured and falls back to HTTPS when SSH is unavailable. Local cloning therefore also depends on the machine’s repository access setup.

Setup and configuration

The aashari/mcp-server-atlassian-bitbucket MCP server runs with Node.js 18 or newer and is distributed as the npm package @aashari/mcp-server-atlassian-bitbucket. The documented MCP configuration uses STDIO, commonly launched with npx -y.

For new configurations, provide ATLASSIAN_USER_EMAIL and ATLASSIAN_API_TOKEN, using the email associated with the Atlassian account. The material also documents the legacy pair ATLASSIAN_BITBUCKET_USERNAME and ATLASSIAN_BITBUCKET_APP_PASSWORD; app passwords are identified as deprecated and scheduled for removal in June 2026. Scoped tokens need Bitbucket repository and workspace scopes for read access, with pull-request scope included for full functionality. Write actions additionally require suitable permissions.

A system-wide configuration may define BITBUCKET_DEFAULT_WORKSPACE. Claude Desktop configuration places the server command and credentials under an MCP server entry; other MCP clients can use the same STDIO approach if they support it.

Tools and capabilities

  • bb_get: Read Bitbucket data, including workspaces, repositories, branches, commits, source files, pull requests, comments, and diffs.
  • bb_post: Create resources or invoke supported actions such as creating, approving, requesting changes on, or merging pull requests.
  • bb_put: Replace resources, including repository metadata and selected branch restriction or file operations.
  • bb_patch: Partially update pull requests, reviewers, repositories, and comments.
  • bb_delete: Remove resources, decline pull requests, remove approvals, or delete comments and repositories.
  • bb_clone: Clone a repository locally through SSH or HTTPS fallback.

The aashari/mcp-server-atlassian-bitbucket MCP server is suited to repository investigation, pull-request workflows, branch comparisons, and agent-driven Bitbucket administration. It targets Bitbucket Cloud rather than Bitbucket Server or Data Center.

Limitations and notes

Credentials and Bitbucket permissions determine which operations succeed. App passwords are a legacy option and should not be selected for new deployments where scoped API tokens are available. File uploads through the PUT interface use multipart form data and are described as more complex than metadata updates. Most delete endpoints return 204 No Content, so successful deletion may produce no response body. Filtering and pagination should be used deliberately to avoid returning unnecessarily large responses.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Server Atlassian Bitbucket

Run `npx -y @aashari/mcp-server-atlassian-bitbucket` and configure it for STDIO in your MCP client.

Yes. The documentation provides a Claude Desktop configuration using the npm package, STDIO, and Bitbucket credentials.

No. The stated requirement is a Bitbucket Cloud account; Bitbucket Server and Data Center are not supported.

Use `ATLASSIAN_USER_EMAIL` with `ATLASSIAN_API_TOKEN`, or the legacy `ATLASSIAN_BITBUCKET_USERNAME` with `ATLASSIAN_BITBUCKET_APP_PASSWORD`.

Related MCP servers

All in Version Control All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Server Atlassian Bitbucket AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/aashari-mcp-server-atlassian-bitbucket?style=directory)](https://allmcps.com/mcp/aashari-mcp-server-atlassian-bitbucket)
HTML Embed
<a href="https://allmcps.com/mcp/aashari-mcp-server-atlassian-bitbucket"><img src="https://allmcps.com/api/badge/aashari-mcp-server-atlassian-bitbucket?style=directory" alt="MCP Server Atlassian Bitbucket on AllMCPs" /></a>