mokkenstorm.dev / bitbucket-tool
cli / mcp for bitbucket
fork atom
bitbucket-tool / packages / cli /
at main 1 folder 3 files
mokkenstorm.dev feat: initial release — MCP server + CLI for Bitbucket Cloud
093f4621
src
README.md
package.json
tsconfig.json
README.md

bitbucket-tool-cli#

CLI for Bitbucket Cloud pull request management.

Installation#

npx bitbucket-tool-cli pr:list --workspace my-ws --repo my-repo

Or install globally:

npm install -g bitbucket-tool-cli

Commands#

Command Description
pr:list List pull requests (alias: prs)
pr:create <source> <title> [description] Create a pull request
pr:update <pr-id> Update or close a pull request
pr:comment <pr-id> <comment> Add a comment to a pull request
pr:comments <pr-id> Get all comments on a pull request

pr:list#

bitbucket-tool-cli pr:list --workspace my-ws --repo my-repo
bitbucket-tool-cli pr:list --state MERGED

Options:

  • -s, --state <state> — Filter by state: OPEN, MERGED, DECLINED, SUPERSEDED (default: OPEN)

pr:create#

bitbucket-tool-cli pr:create feature/login "Add login page" "Implements OAuth login" \
  --workspace my-ws --repo my-repo

Options:

  • -d, --destination <branch> — Destination branch (default: main)

pr:update#

bitbucket-tool-cli pr:update 42 --title "New title" --workspace my-ws --repo my-repo
bitbucket-tool-cli pr:update 42 --close

Options:

  • -t, --title <title> — Update PR title
  • -d, --description <desc> — Update PR description
  • --destination <branch> — Update destination branch
  • --close — Close/decline the pull request

pr:comment#

bitbucket-tool-cli pr:comment 42 "LGTM" --workspace my-ws --repo my-repo

pr:comments#

bitbucket-tool-cli pr:comments 42 --workspace my-ws --repo my-repo

Authentication#

Set one of:

  • API token: BITBUCKET_TOKEN env var
  • OAuth 2.0: BITBUCKET_OAUTH_CLIENT_ID + BITBUCKET_OAUTH_CLIENT_SECRET

Optionally set BITBUCKET_WORKSPACE as a default workspace.

License#

MIT