Skip to main content
Glama
Sign In
Atlassian Bitbucket MCP Server

Atlassian Bitbucket MCP Server

by guenichone
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Atlassian Bitbucket MCP Server

A Model Context Protocol (MCP) server that integrates Atlassian Bitbucket Server/Data Center with AI systems.

What It Does

This server enables AI systems to interact with Bitbucket repositories by providing:

  • Access to projects, repositories, branches, and files

  • Tools for working with pull requests

  • Type-safe API integration with official Bitbucket OpenAPI specs

Related MCP server: Bitbucket MCP

Quick Setup

Prerequisites

  • Node.js (v20+ recommended)

  • npm

  • Python 3 (for OpenAPI filtering script)

  • Bitbucket Server access token

Installation

git clone [<atlassian-bitbucket-server-mcp>](https://github.com/guenichone/atlassian-bitbucket-server-mcp)
cd mcp-server-selfhosted-bitbucket
npm install
npm run build-app

Running the Server

# As STDIO server (default for AI integration)
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

# As HTTP/SSE server
MCP_TRANSPORT=sse \
ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
npm start

Docker Usage

Using Docker CLI

# Build
docker build -t bitbucket-mcp-server .

# Run
docker run --rm -i \
  -e ATLASSIAN_BITBUCKET_SERVER_URL=https://git.your-company.com/ \
  -e ATLASSIAN_BITBUCKET_ACCESS_TOKEN=your-token \
  bitbucket-mcp-server

Using the Makefile (Recommended)

The project includes a Makefile for simplified Docker operations:

# Build the Docker image
make docker-build

# Run with your Bitbucket credentials
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-run

# Build and run in one command
BITBUCKET_URL=https://git.your-company.com/ BITBUCKET_TOKEN=your-token make docker-all

# View all available make commands and examples
make help

Environment Variables

  • ATLASSIAN_BITBUCKET_SERVER_URL - Bitbucket server URL

  • ATLASSIAN_BITBUCKET_ACCESS_TOKEN - Your access token

  • MCP_TRANSPORT - stdio (default) or sse

  • PORT - HTTP port when using SSE (default: 3000)

Thanks

This project was inspired by aashari/mcp-server-atlassian-bitbucket.

License

MIT - See LICENSE file for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Bitbucket MCP

      Nicholas80932
      A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Bitbucket Cloud and Server APIs to list and retrieve repositories, fetch and create pull requests, and manage related resources through natural language.
      5,856 npm
      MIT

    • Bitbucket MCP

      Girard602
      A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Bitbucket repositories, pull requests, and related resources through the Bitbucket Cloud and Server APIs. It supports operations such as listing repositories, retrieving repository details, and fetching or creating pull requests.
      5,856 npm
      MIT

    • Bitbucket MCP

      Marta485
      A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Bitbucket repositories and pull requests via Cloud and Server APIs, including listing repositories, retrieving details, fetching pull requests, and creating pull requests.
      5,856 npm
      MIT

    • Bitbucket MCP

      HugoKwon7312
      A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to interact with Bitbucket repositories and pull requests, including listing repositories, retrieving repository details, fetching pull requests, and creating pull requests through Bitbucket Cloud and Server APIs.
      5,856 npm
      MIT