This provides a go bitbucket cli bb-cli, an mcp server bb-mcp and a terraform provider. All by focusing on low maintenance using auto generation from the official OpenAPI Spec.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add bitbucket-fabianschurig --env BITBUCKET_TOKEN='<BITBUCKET_TOKEN>' -- docker run -i --rm -e BITBUCKET_TOKEN ghcr.io/fabianschurig/bitbucket-mcp:0.20.2~/.codex/config.toml
[mcp_servers.bitbucket-fabianschurig]
command = "docker"
args = ["run", "-i", "--rm", "-e", "BITBUCKET_TOKEN", "ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"]
env = { BITBUCKET_TOKEN = "<BITBUCKET_TOKEN>" }
# codex mcp add bitbucket-fabianschurig --env BITBUCKET_TOKEN='<BITBUCKET_TOKEN>' -- docker run -i --rm -e BITBUCKET_TOKEN ghcr.io/fabianschurig/bitbucket-mcp:0.20.2~/.cursor/mcp.json
{
"mcpServers": {
"bitbucket-fabianschurig": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BITBUCKET_TOKEN",
"ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"
],
"env": {
"BITBUCKET_TOKEN": "<BITBUCKET_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"bitbucket-fabianschurig": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BITBUCKET_TOKEN",
"ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"
],
"env": {
"BITBUCKET_TOKEN": "<BITBUCKET_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"bitbucket-fabianschurig": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BITBUCKET_TOKEN",
"ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"
],
"env": {
"BITBUCKET_TOKEN": "<BITBUCKET_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"bitbucket-fabianschurig": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BITBUCKET_TOKEN",
"ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"
],
"env": {
"BITBUCKET_TOKEN": "<BITBUCKET_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"bitbucket-fabianschurig": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BITBUCKET_TOKEN",
"ghcr.io/fabianschurig/bitbucket-mcp:0.20.2"
],
"env": {
"BITBUCKET_TOKEN": "<BITBUCKET_TOKEN>"
}
}
}
}Environment variables
BITBUCKET_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.