bitbucket-mcp

library0.5.0jsnpmunverified

A Model Context Protocol (MCP) server for integrating with Bitbucket Cloud and Server APIs. Version 5.0.6, actively maintained. Allows AI assistants (e.g., Cursor) to interact with Bitbucket repositories and pull requests via tool calls. Safe design: no DELETE operations. Requires Node >=18. ESM-only. Supports both Bitbucket Cloud and Server via configuration.

devops http-networking

npm install bitbucket-mcp

github ↗package ↗

INSTALL

IMPORT

SIG · BITBUCKET-MCP

bitbucket-mcp

devopsjavascriptv0.5.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

BitbucketServer

✓ import { BitbucketServer } from 'bitbucket-mcp'

✗ const BitbucketServer = require('bitbucket-mcp')

ESM-only package; named export.

BitbucketCloud

✓ import { BitbucketCloud } from 'bitbucket-mcp'

✗ import BitbucketCloud from 'bitbucket-mcp'

Named export, not default.

createServer

✓ import { createServer } from 'bitbucket-mcp'

✗ import { startServer } from 'bitbucket-mcp'

Correct function is named 'createServer'.

Creates and starts an MCP server connected to Bitbucket Cloud, using environment variables for authentication and workspace.

import { createServer } from 'bitbucket-mcp'; const server = createServer({ url: process.env.BITBUCKET_URL || 'https://api.bitbucket.org/2.0', username: process.env.BITBUCKET_USERNAME ?? '', password: process.env.BITBUCKET_PASSWORD ?? '', workspace: process.env.BITBUCKET_WORKSPACE ?? '' }); server.listen(3100).then(() => { console.log('Bitbucket MCP server running on port 3100'); });

Debug

Known issues

breakingIn v5.0.0, the environment variable BITBUCKET_REPOSITORY was removed; use BITBUCKET_WORKSPACE instead.

fix

Set BITBUCKET_WORKSPACE env var instead of BITBUCKET_REPOSITORY.

affects: >=5.0.0

breakingIn v5.0.0, the legacy env var BITBUCKET_API_URL was replaced by BITBUCKET_URL.

fix

Use BITBUCKET_URL instead of BITBUCKET_API_URL.

affects: >=5.0.0

deprecatedOption B (web URL only) for BITBUCKET_URL is deprecated since v5.0.0; workspace auto-extraction will be removed in the future.

fix

Use Option A: set BITBUCKET_URL to 'https://api.bitbucket.org/2.0' and explicitly set BITBUCKET_WORKSPACE.

affects: >=5.0.0

gotchaThe package is ESM-only: cannot be imported with require().

fix

Use import syntax or dynamic import().

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'bitbucket-mcp'

Bitbucket MCP is not installed or not in node_modules.

fix

Run 'npm install bitbucket-mcp' in your project directory.

Error: Workspace is required

BITBUCKET_WORKSPACE environment variable is not set.

fix

Set the BITBUCKET_WORKSPACE env var to your Bitbucket workspace.

Error: Authentication failed (401)

Invalid or missing username/app password credentials.

fix

Ensure BITBUCKET_USERNAME and BITBUCKET_PASSWORD are set correctly.

Upgrade

Version history

0.5.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/MatanYemini/bitbucket-mcp ↗

packagehttps://www.npmjs.com/package/bitbucket-mcp ↗