Skip to main content
Glama
guenichone

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.

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo 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.
    2,907 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.
    2,907 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.
    2,907 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.
    2,907 npm
    MIT