{"id":18166,"library":"bitbucket-mcp","title":"Bitbucket MCP","description":"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.","status":"active","version":"5.0.6","language":"javascript","source_language":"en","source_url":"https://github.com/MatanYemini/bitbucket-mcp","tags":["javascript","bitbucket","bitbucket-cloud","bitbucket-server","mcp","model-context-protocol","ai","llm","typescript"],"install":[{"cmd":"npm install bitbucket-mcp","lang":"bash","label":"npm"},{"cmd":"yarn add bitbucket-mcp","lang":"bash","label":"yarn"},{"cmd":"pnpm add bitbucket-mcp","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"ESM-only package; named export.","wrong":"const BitbucketServer = require('bitbucket-mcp')","symbol":"BitbucketServer","correct":"import { BitbucketServer } from 'bitbucket-mcp'"},{"note":"Named export, not default.","wrong":"import BitbucketCloud from 'bitbucket-mcp'","symbol":"BitbucketCloud","correct":"import { BitbucketCloud } from 'bitbucket-mcp'"},{"note":"Correct function is named 'createServer'.","wrong":"import { startServer } from 'bitbucket-mcp'","symbol":"createServer","correct":"import { createServer } from 'bitbucket-mcp'"}],"quickstart":{"code":"import { createServer } from 'bitbucket-mcp';\n\nconst server = createServer({\n  url: process.env.BITBUCKET_URL || 'https://api.bitbucket.org/2.0',\n  username: process.env.BITBUCKET_USERNAME ?? '',\n  password: process.env.BITBUCKET_PASSWORD ?? '',\n  workspace: process.env.BITBUCKET_WORKSPACE ?? ''\n});\n\nserver.listen(3100).then(() => {\n  console.log('Bitbucket MCP server running on port 3100');\n});","lang":"typescript","description":"Creates and starts an MCP server connected to Bitbucket Cloud, using environment variables for authentication and workspace."},"warnings":[{"fix":"Set BITBUCKET_WORKSPACE env var instead of BITBUCKET_REPOSITORY.","message":"In v5.0.0, the environment variable BITBUCKET_REPOSITORY was removed; use BITBUCKET_WORKSPACE instead.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Use BITBUCKET_URL instead of BITBUCKET_API_URL.","message":"In v5.0.0, the legacy env var BITBUCKET_API_URL was replaced by BITBUCKET_URL.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Use Option A: set BITBUCKET_URL to 'https://api.bitbucket.org/2.0' and explicitly set BITBUCKET_WORKSPACE.","message":"Option B (web URL only) for BITBUCKET_URL is deprecated since v5.0.0; workspace auto-extraction will be removed in the future.","severity":"deprecated","affected_versions":">=5.0.0"},{"fix":"Use import syntax or dynamic import().","message":"The package is ESM-only: cannot be imported with require().","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install bitbucket-mcp' in your project directory.","cause":"Bitbucket MCP is not installed or not in node_modules.","error":"Error: Cannot find module 'bitbucket-mcp'"},{"fix":"Set the BITBUCKET_WORKSPACE env var to your Bitbucket workspace.","cause":"BITBUCKET_WORKSPACE environment variable is not set.","error":"Error: Workspace is required"},{"fix":"Ensure BITBUCKET_USERNAME and BITBUCKET_PASSWORD are set correctly.","cause":"Invalid or missing username/app password credentials.","error":"Error: Authentication failed (401)"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}