What it does
Bitbucket MCP is a Model Context Protocol server that bridges AI assistants like Claude or Cursor to Bitbucket Cloud and Server APIs. It enables read and write access to repositories, pull requests, and related metadata, allowing Claude to browse code context, retrieve PR details, and perform API operations without data loss risk (write operations exclude destructive deletions).
Who it's for
Backend engineers and development teams using Bitbucket who want Claude or Cursor to interact with their repositories—reviewing pull requests, summarizing code changes, or gathering context for code analysis without manually opening Bitbucket in a browser.
Common use cases
- Fetch pull request details and review history from Claude
- Query repository metadata, branches, and commit information
- Browse code structure and repository contents
- Gather context for AI-assisted code review and analysis
Setup pitfalls
- Requires Bitbucket app password (not your regular account password); create one in Personal Settings > App Passwords with proper scopes: Repositories Read, Pull Requests Read/Write, Pipelines Read.
- Workspace auto-detection depends on URL format—if authentication fails with 401 errors, try the explicit API URL format (
https://api.bitbucket.org/2.0) and setBITBUCKET_WORKSPACEexplicitly. - One credential secret detected in the repository—ensure all credentials are set via environment variables, never committed.
- Project last updated 34 days ago with no recent CI passing; verify compatibility with your Bitbucket instance version before deploying.