bbkt (Bitbucket CLI & MCP Server)
A complete command-line interface and Model Context Protocol (MCP) server written in Go that provides programmatic integration with Bitbucket Cloud workspaces and repositories.
Features
- Dual mode — Use as an interactive CLI for daily work, or launch as an MCP server (
bbkt mcp) for AI agents (Claude Desktop, Cursor, etc.). - Git-aware — Most commands auto-detect the current workspace and repo from
.git/config, sobbkt prs listJust Works inside a Bitbucket repo. - Multi-profile — Switch between personal and work Atlassian accounts with
--profileorBBKT_PROFILE; auto-selects the right profile based on your git config email. - Two auth modes — Atlassian API tokens (Basic auth) or interactive OAuth 2.0 with automatic token refresh.
- Scope-aware MCP — At startup the MCP server introspects your token's granted scopes and silently hides tools the token can't use, preventing the AI from hallucinating successful writes it doesn't have permission for.
- Read and write — Repositories, workspaces, pipelines, issues, pull requests, comments, and source code (read/write/delete) — all via the API.
