Atlassian Bitbucket MCP Server

A Node.js/TypeScript Model Context Protocol server for Atlassian Bitbucket Cloud. It lets MCP clients interact with Bitbucket workspaces, repositories, pull requests, comments, code search, files, branches, diffs, commit history, and repository cloning workflows.

Install and Launch

The upstream README documents this MCP client launch:

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
    }
  }
}

This Wardn registry entry is pinned to the reviewed npm package target, so the submitted launch metadata uses:

{
  "command": "npx",
  "args": ["-y", "@aashari/[email protected]"],
  "type": "stdio"
}

The reviewed dist/index.js and src/index.ts start the MCP server over stdio when no CLI subcommand is provided. The source includes an unsupported SSE code path, but non-stdio transport throws an error; the askanuradha Streamable HTTP /mcp port 3001 behavior is not part of the reviewed npm package target.

Authentication

Two auth modes are supported. Recommended Bitbucket App Password auth uses ATLASSIAN_BITBUCKET_USERNAME and ATLASSIAN_BITBUCKET_APP_PASSWORD. Atlassian API token auth uses ATLASSIAN_SITE_NAME, ATLASSIAN_USER_EMAIL, and ATLASSIAN_API_TOKEN. Optional BITBUCKET_DEFAULT_WORKSPACE supplies a default workspace when tools omit one.

Configuration can be supplied directly through environment variables, a project .env, or ~/.mcp/configs.json under one of the documented package keys.

Capabilities

MCP tools reviewed in the package are bb_ls_workspaces, bb_get_workspace, bb_ls_repos, bb_get_repo, bb_get_commit_history, bb_add_branch, bb_clone_repo, bb_get_file, bb_list_branches, bb_ls_prs, bb_get_pr, bb_ls_pr_comments, bb_add_pr_comment, bb_add_pr, bb_search, bb_diff_branches, and bb_diff_commits. Responses are formatted as Markdown.

CLI Mode

If command-line arguments are supplied, the entrypoint dispatches to Commander CLI commands such as ls-workspaces, get-workspace, ls-repos, get-repo, search, ls-prs, get-pr, ls-pr-comments, add-pr-comment, add-pr, get-file, add-branch, get-commit-history, diff-branches, diff-commits, list-branches, and clone. These commands and their options are recorded as optional package arguments and are not part of the default MCP server launch.

Limitations

Requires Node.js 18 or newer and a Bitbucket Cloud account. Credentials are required for Bitbucket API calls. The reviewed package target is npm @aashari/[email protected] from the aashari repository/tag v1.39.5; the packaged runtime VERSION constant aligns with the reviewed npm package version 1.39.5; dist/utils/constants.util.js and .d.ts both set VERSION to 1.39.5, while only a non-runtime .bak file contains an older string. The reviewed target does not implement the askanuradha Streamable HTTP server on /mcp port 3001. Repository cloning writes to local filesystem paths supplied by the tool caller and may require local Git/SSH configuration.