Bitbucket MCP Server

Developmentstdiov1.0.0

MCP server for Atlassian Bitbucket that connects AI tools to repositories, pull requests, branches, and pipelines. Enables agents to review and create pull requests, read file contents and diffs, leave comments, and inspect build status on Bitbucket Cloud and Server.

bitbucket git version-control pull-requests atlassian code-review

Connect

Add this configuration to .claude/mcp.json

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "args": [
        "-y",
        "bitbucket-mcp"
      ],
      "env": {
        "BITBUCKET_USERNAME": "<YOUR_BITBUCKET_USERNAME>",
        "BITBUCKET_APP_PASSWORD": "<YOUR_BITBUCKET_APP_PASSWORD>"
      }
    }
  }
}

Tools (3)

list_pull_requests

List pull requests for a repository with optional state filter.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug"
  ],
  "properties": {
    "state": {
      "type": "string",
      "description": "PR state (OPEN, MERGED, DECLINED)"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Bitbucket workspace ID"
    }
  }
}

create_pull_request

Create a pull request between two branches.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "source_branch",
    "destination_branch",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Pull request title"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Bitbucket workspace ID"
    },
    "source_branch": {
      "type": "string",
      "description": "Source branch"
    },
    "destination_branch": {
      "type": "string",
      "description": "Destination branch"
    }
  }
}

get_file

Read the contents of a file at a given ref.

{
  "type": "object",
  "required": [
    "workspace",
    "repo_slug",
    "path"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Branch, tag, or commit"
    },
    "path": {
      "type": "string",
      "description": "File path"
    },
    "repo_slug": {
      "type": "string",
      "description": "Repository slug"
    },
    "workspace": {
      "type": "string",
      "description": "Bitbucket workspace ID"
    }
  }
}

Resources

This server does not expose any resources.

Prompts

This server does not expose any prompts.

Server Information

Author: Atlassian Community (@MatanYemini)
Repository: https://github.com/MatanYemini/bitbucket-mcp
License: MIT
Version: 1.0.0
Stars: 410
Last Updated: June 24, 2026