PlugWiki
mcp-server-atlassian-bitbucket logo

Bitbucket MCP Server by Aashari: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpm@aashari/mcp-server-atlassian-bitbucketaashari/mcp-server-atlassian-bitbucket

Not the official Atlassian MCP server. This one is built by the community. Atlassian makes its own: Atlassian Rovo MCP Server →

Tools
6
1 read · 5 change
Stars
164
on GitHub
Downloads
12.1K
a week
Works in
12
apps
Risk
High
can delete

Lets Claude, Cursor or another assistant read and change Bitbucket Cloud repositories and pull requests, using your own API token.

This is a community server by Aashari. Atlassian did not make it, and it works with Bitbucket Cloud only, not Bitbucket Server or Data Center. It runs on your computer with npx.

You sign in with your Atlassian email and a scoped API token. The README recommends the token over the old app password, which it says is being removed by June 2026. Five of the six tools call the raw Bitbucket API, so the assistant can reach anything your token allows, including deletes.

Good for

  • Developers who review pull requests and want the assistant to read diffs and comments
  • Team leads who want a quick view of open work across a workspace
  • DevOps engineers who script branch and repo chores in plain language

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install mcp-server-atlassian-bitbucket

Claude Code

  1. 1

    Copy this prompt.

    Add the mcp-server-atlassian-bitbucket server to Claude Code. Run this command:

claude mcp add atlassian-bitbucket -e ATLASSIAN_USER_EMAIL=<ATLASSIAN_USER_EMAIL> -e ATLASSIAN_API_TOKEN=<ATLASSIAN_API_TOKEN> -- npx -y @aashari/mcp-server-atlassian-bitbucket

Ask me for ATLASSIAN_USER_EMAIL, ATLASSIAN_API_TOKEN and only put the values in that config, nowhere else.

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us.

Tools

  • Reads any Bitbucket data

    Sends a read request to any Bitbucket Cloud API path, such as workspaces, repos, pull requests, diffs, branches, commits or file contents. You can filter results with a JMESPath expression and a page size, which keeps answers short and cheap.

    Try: “List the open pull requests in acme/payments.”

    Network · bb_get

  • Creates things in Bitbucket

    Sends a create request to a Bitbucket API path, for example a new pull request, a pull request comment or a branch.

    Try: “Create a pull request from feature/login into main.”

    Write · bb_post

  • Replaces a Bitbucket resource

    Sends a full-replace update to a Bitbucket API path. Fields you leave out may be reset by Bitbucket.

    Try: “Update the default reviewers for acme/payments.”

    Write · bb_put

  • Changes part of a Bitbucket resource

    Sends a partial update to a Bitbucket API path, such as editing a pull request title or description.

    Try: “Rename pull request 123 to "Fix login redirect".”

    Write · bb_patch

  • Deletes things in Bitbucket

    Sends a delete request to a Bitbucket API path. It can remove resources such as branches, comments or repositories if your token allows it. The tool is marked destructive.

    Try: “Delete the merged branch feature/old-login.”

    Delete · bb_delete

  • Clones a repo to your computer

    Runs git clone for a Bitbucket repo into a folder you name, using the SSH address if there is one and HTTPS otherwise. It needs git installed and, for SSH, your keys set up.

    Try: “Clone acme/payments into ~/code/payments.”

    Runs code · bb_clone

Read from the source code

Permissions

high risk · 4 things to watch

High risk

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can delete Bitbucket resources

    bb_delete sends a delete request to any API path your token reaches. Approve each call by hand, and leave out scopes you do not need. github.com

  • It can create and change pull requests and repos

    bb_post, bb_put and bb_patch write to any API path. A token without the pullrequest scope blocks pull request changes, but the tools are still listed. github.com

  • It runs git and writes to your disk

    bb_clone runs git clone into the folder the assistant names. Check the target path before you approve it. github.com

  • The legacy app password is going away

    The README says Bitbucket app passwords are being deprecated and will be removed by June 2026, and recommends a scoped API token instead. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toBitbucket Cloud API (the Bitbucket REST API)
Sign-in and keysYour email and API token are passed as environment variables in your client config.
Scopes

  • Scoped API token with Bitbucket scopes: repository and workspace for reading, plus pullrequest for pull request changes.

Questions

Is the Bitbucket MCP server by Aashari official?

No. Aashari, an independent developer, made it and Atlassian is not involved. Atlassian's own hosted Atlassian Rovo MCP server does cover Bitbucket Cloud (list and read repositories, pull requests, diffs and pipelines, plus write tools). Its Bitbucket tools are only available when your Bitbucket workspace is linked to an Atlassian organization. This community server works with a plain Bitbucket Cloud API token instead.

How do I get the credentials?

Create a scoped API token at id.atlassian.com with Bitbucket as the product, then use it with your Atlassian email. For read-only use pick the repository and workspace scopes; add pullrequest for pull request changes.

Can I run it read-only?

Not with a switch in the server. The README documents none. A token with only the repository and workspace scopes limits what Bitbucket will accept, but bb_post, bb_put, bb_patch, bb_delete and bb_clone are still listed.

Does it work with Bitbucket Server or Data Center?

No. The README says it needs a Bitbucket Cloud account.

Can it delete branches or repositories?

Yes, if your token allows it. The delete tool sends a delete request to any Bitbucket API path you give it.

Does it run locally?

Yes. By default it runs on your computer over stdio and talks to the Bitbucket API. An optional HTTP mode listens on 127.0.0.1 only.

Is it free?

Yes. The package is ISC licensed. You need a Bitbucket Cloud account.

Information

updated Nov 2, 2026

Publisher
Community
Package
@aashari/mcp-server-atlassian-bitbucket
Registry
npm
Transport
stdio, Streamable HTTP
Auth
token in env
Version
3.1.0
License
ISC
Last commit
Mar 6, 2026
Open issues
10

GitHubnpmChangelogIssues

Other Atlassian MCP servers

See all

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 6
  1. README.md · github.com
  2. atlassian.api.tool.ts · github.com
  3. atlassian.repositories.tool.ts · github.com
  4. package.json · github.com
  5. index.ts · github.com
  6. Atlassian Rovo MCP server supported tools · support.atlassian.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.