Skip to content
Bitbucket MCP Server

Requirements

Before installing the Bitbucket MCP Server, make sure you have the following.

Node.js 18+

Section titled “Node.js 18+”

The server uses the native fetch API, which requires Node.js 18 or later.

Terminal window
node --version
# Should output v18.x.x or higher

Bitbucket Authentication

Section titled “Bitbucket Authentication”

The server authenticates using API token + email. You will need:

  • A Bitbucket (Atlassian) account
  • An API token scoped to Bitbucket read operations
  • Your Atlassian account email address

Creating an API Token

Section titled “Creating an API Token”

  1. Go to https://id.atlassian.com/manage-profile/security/api-tokens and click “Create API token with scopes”.

    API Tokens page showing "Create API token with scopes" button

  2. Enter a name (e.g., Bitbucket MCP) and set an expiry date, then click “Next”.

    Name and expiry step with "Bitbucket MCP" entered as the token name

  3. Select “Bitbucket” from the app list and click “Next”.

    Select app step with Bitbucket selected

  4. Click “Scope actions” and filter by “Read”, then set Results per page to 20. Check all checkboxes and click “Next”.

    Select scopes step filtered to Read scopes with all 18 checked

  5. Review the token summary and click “Create token”.

    Review your API token step showing Bitbucket MCP with all Read scopes

  6. Copy the generated token immediately — it’s shown only once. This is your BITBUCKET_API_TOKEN.

    Copy API token step showing the generated token

  7. Use your Atlassian account email as BITBUCKET_EMAIL.

Section titled “Code Search (Highly Recommended)”

The bb_search_code tool requires code search to be enabled in your Bitbucket account settings.

Enable it at https://bitbucket.org/search.

Without this, all other 36 tools work normally — only bb_search_code is affected.