Bitbucket CLI for AI Agents

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP. With Composio's Universal CLI, your coding agents can talk to over 1000+ SaaS applications. With Bitbucket, agents can create a new branch off main, open a pull request for your feature, comment on the latest open issue, and more — all without worrying about authentication. This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Bitbucket automation.

Get started for freeGet a demo
Bitbucket logoBitbucket
Oauth2

Bitbucket is a Git-based code hosting and collaboration platform for teams. It enables secure repository management and streamlined code reviews.

105 Tools

Introduction

CLIs are eating MCPs. The industry is converging on the very same idea. MCPs for all their merit can be token hungry, slow, and unreliable for complex tool chaining. However, coding agents have become incredibly good at working with CLIs, and in fact they are far more comfortable working with CLI tools than MCP.

With Composio's Universal CLI, your coding agents can talk to over 1000+ SaaS applications. With Bitbucket, agents can create a new branch off main, open a pull request for your feature, comment on the latest open issue, and more — all without worrying about authentication.

This guide walks you through Composio Universal CLI and explains how you can connect it with coding agents like Claude Code, Codex, OpenCode, etc, for end-to-end Bitbucket automation.

Also integrate Bitbucket with

ChatGPTOpenAI Agents SDKClaude Agent SDKClaude CodeClaude CoworkCodexOpenCodeCursorVS CodeOpenClawHermesGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAI

What is Universal CLI and why use it?

The idea behind building the universal CLI is to give agents a single command interface to interact with all your external applications. Here's what you'll get with it:

  • Agent-friendly: Coding agents like Claude Code, Codex, and OpenCode can use CLI tools natively — no MCP setup required.
  • Authentication handled: Connect once via OAuth or API Key, and all CLI commands work with your credentials automatically.
  • Tool discovery: Search, inspect, and execute 20,000+ tools across 1000+ apps from one interface.
  • Trigger support: Use triggers to listen for events across your apps, powered by real-time webhooks or polling under the hood.
  • Type generation: Generate typed schemas for autocomplete and type safety in your projects.

Prerequisites

Install the Composio CLI, authenticate, and initialize your project:

bash
# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Authenticate with Composio
composio login

During login you'll be redirected to sign in page, finish the complete flow and you're all set.

Composio CLI authentication flow

Connecting Bitbucket to Coding Agents via Universal CLI

Once it is installed, it's essentially done. Claude Code, Codex, OpenCode, OpenClaw, or any other agent will be able to access the CLI. A few steps to give agents access to your apps.

  1. Launch your Coding Agent — Claude Code, Codex, OpenCode, anything you prefer.
  2. Prompt it to "Authenticate with Bitbucket"
  3. Complete the authentication and authorization flow and your Bitbucket integration is all set.
  4. Start asking anything you want.

Universal CLI Commands for Bitbucket

You can also manually execute CLI commands to interact with your Bitbucket.

Connect your Bitbucket account

Link your Bitbucket account and verify the connection:

bash
# Connect your Bitbucket account (opens OAuth flow)
composio connected-accounts link bitbucket

# Verify the connection
composio connected-accounts list --toolkits bitbucket

Discover Bitbucket tools

Search and inspect available Bitbucket tools:

bash
# List all available Bitbucket tools
composio tools list --toolkit bitbucket

# Search for Bitbucket tools by action
composio tools search "bitbucket"

# Inspect a tool's input schema
composio tools info BITBUCKET_CREATE_BRANCH

Common Bitbucket Actions

Create a branch — Creates a new branch in a bitbucket repository from a target commit hash; the branch name must be unique, adhere to bitbucket's naming conventions, and not include the 'refs/heads/' prefix

bash
composio tools execute BITBUCKET_CREATE_BRANCH \
  --name "feature/new-branch" \
  --repo_slug "my-repo" \
  --workspace "my-workspace" \
  --target_hash "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0"

Create an issue — Creates a new issue in a bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component ids exist

bash
composio tools execute BITBUCKET_CREATE_ISSUE \
  --title "Bug: Login not working" \
  --content "Users are unable to log in when using Firefox browser" \
  --repo_slug "repo-name" \
  --workspace "workspace123"

Create an issue comment — Adds a new comment with markdown support to an existing bitbucket issue

bash
composio tools execute BITBUCKET_CREATE_ISSUE_COMMENT \
  --content "This is a comment with **bold** text" \
  --issue_id "123" \
  --repo_slug "my-repo" \
  --workspace "my-workspace"

Create a pull request — Creates a new pull request in a specified bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch

bash
composio tools execute BITBUCKET_CREATE_PULL_REQUEST \
  --title "Feature: Add new login page" \
  --repo_slug "my-repo" \
  --workspace "my-workspace" \
  --source_branch "feature/login-page"

Generate Type Definitions

Generate typed schemas for Bitbucket tools to get autocomplete and type safety in your project:

bash
# Auto-detect language
composio generate --toolkits bitbucket

# TypeScript
composio ts generate --toolkits bitbucket

# Python
composio py generate --toolkits bitbucket

Tips & Tricks

  • Always inspect a tool's input schema before executing: composio tools info <TOOL_NAME>
  • Pipe output with jq for better readability: composio tools execute TOOL_NAME -d '{}' | jq
  • Set COMPOSIO_API_KEY as an environment variable for CI/CD pipelines
  • Use composio dev logs tools to inspect execution logs and debug issues

Next Steps

  • Try asking your coding agent to perform various Bitbucket operations
  • Explore cross-app workflows by connecting more toolkits
  • Set up triggers for real-time automation
  • Use composio generate for typed schemas in your projects
TOOLS

Supported Tools

Every Bitbucket action and event your agent gets out of the box.

Approve Pull Request

Tool to approve a pull request as the authenticated user.

Browse repository path

Tool to retrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository.

Create a branch

Creates a new branch in a Bitbucket repository from a target commit hash; the branch name must be unique, adhere to Bitbucket's naming conventions, and not include the 'refs/heads/' prefix.

Create an issue

Creates a new issue in a Bitbucket repository, setting the authenticated user as reporter; ensures assignee (if provided) has repository access, and that any specified milestone, version, or component IDs exist.

Create an issue comment

Adds a new comment with markdown support to an existing Bitbucket issue.

Create a pull request

Creates a new pull request in a specified Bitbucket repository, ensuring the source branch exists and is distinct from the (optional) destination branch.

Create pull request comment

Creates a new comment on a Bitbucket pull request.

Create commit report annotations

Adds multiple annotations to a commit report in bulk.

List commits from revision (POST)

Tool to list commits from a revision using POST method.

Create repository

Creates a new Bitbucket 'git' repository in a specified workspace, defaulting to the workspace's oldest project if `project_key` is not provided.

Create snippet comment

Posts a new top-level comment or a threaded reply to an existing comment on a specified Bitbucket snippet.

Create team pipeline variable

Creates a team-level pipeline configuration variable in Bitbucket.

Create user pipeline variable

Creates a user-level pipeline variable for Bitbucket pipelines.

Delete commit comment

Permanently deletes a specific comment on a commit.

Delete issue

Permanently deletes a specific issue, identified by its `issue_id`, from the repository specified by `repo_slug` within the given `workspace`.

Delete pull request comment

Permanently deletes a specific pull request comment (top-level, inline, or threaded reply).

Delete commit report annotation

Deletes a single annotation matching the provided ID from a commit report.

Delete repository

Permanently deletes a specified Bitbucket repository; this action is irreversible and does not affect forks.

Delete snippet watch

Stops watching a specific snippet.

Delete user pipeline variable

Permanently deletes a user-level pipeline configuration variable identified by its UUID.

Get branch

Retrieves detailed information about a specific branch in a Bitbucket repository.

Get Commit Build Status

Get a specific build status for a commit in Bitbucket.

Get Commit Changes

Tool to retrieve a page of changes made in a specified commit, showing all changed files with their change statistics (lines added/removed, status).

Get commit comment

Retrieves a specific comment from a commit by its ID.

Get Commit Diff

Tool to retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository.

Get current user (v2)

Tool to retrieve complete profile information for the currently authenticated Bitbucket user.

Get deployment environment variables

Retrieves deployment environment level variables for a specific Bitbucket repository environment.

Get file from repository

Retrieves a specific file's content from a Bitbucket repository at a given commit (hash, branch, or tag), failing if the file path is invalid for that commit.

Get hook events

Retrieves a paginated list of all valid webhook events for a specified entity type (repository or workspace).

Get OpenID configuration for OIDC in Pipelines

Retrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC.

Get Pull Request

Get a single pull request by ID with complete details.

Get pull request comment

Tool to retrieve a specific comment from a pull request by its ID.

Get Pull Request Commits

Tool to retrieve commits for a specified pull request.

Get Pull Request Diff

Tool to fetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff).

Get Pull Request Diffstat

Tool to get the diffstat for a Bitbucket pull request, showing all changed files with their change statistics (lines added/removed, status).

Get Repository Branching Model

Return the branching model as applied to the repository.

Get Repository Commit

Tool to retrieve detailed information about a specific commit in a Bitbucket repository.

Get commit comments

Retrieves all comments on a specific commit in a Bitbucket repository.

Get commit report

Returns a single report matching the provided ID from a commit.

Get Commit Reports

Tool to get reports linked to a specific commit.

Get commit report annotation

Returns a single annotation matching the provided ID from a commit report.

Get commit statuses

Returns all build statuses (e.

Get effective branching model

Retrieves the effective branching model for a Bitbucket repository, showing which branching model is currently applied (including any inheritance from project-level settings).

Get Repository Environment

Retrieve detailed information about a specific deployment environment in a Bitbucket repository.

Get file commit history

Returns a paginated list of commits that modified the specified file.

Check if user voted for issue

Tool to check whether the authenticated user has voted for a specific issue in a Bitbucket repository.

Get Repositories Merge Base

Get the merge base (best common ancestor) between two commits in a Bitbucket repository.

Get specific pipeline

Retrieve a specified pipeline from a Bitbucket repository.

Get repository pipelines caches

Retrieves the repository pipelines caches.

Get repository pipeline runners

Retrieves the list of self-hosted runners configured for a repository's pipelines.

Get repository pipeline schedules

Retrieves configured pipeline schedules for a Bitbucket repository.

Get repository SSH known hosts

Retrieves repository-level SSH known hosts configured for Bitbucket Pipelines.

Get repository pipeline variables

Retrieves repository-level pipeline variables for a specific Bitbucket repository.

Get pipeline steps

Retrieves all steps for a given pipeline.

Get pull requests activity log

Get paginated activity log for all pull requests in a repository.

Get pull request comments

Retrieves a paginated list of comments on a specific pull request in a Bitbucket repository.

Get pull request statuses

Returns all build statuses (e.

Get repository refs

Returns the branches and tags in the repository.

Get tag

Retrieves detailed information about a specific tag in a Bitbucket repository.

Get repositories src

Lists the contents of the root directory on the repository's main branch without needing to specify a commit or branch.

Get repository watchers

Retrieves a paginated list of all the watchers on the specified repository.

Get repository

Retrieves detailed information about a specific repository in a Bitbucket workspace.

Get Repository Patch

Tool to retrieve the git patch content for a Bitbucket repository at a specified revision or commit range.

Get snippet

Retrieves a specific Bitbucket snippet by its encoded ID from an existing workspace, returning its metadata and file structure.

Get snippet watch status

Checks if the current user is watching a specific snippet.

Get SSH keys for user

Retrieves a paginated list of SSH keys for a specified Bitbucket user.

Get user

Retrieves public profile information for a specific Bitbucket user by username or UUID.

Get user emails

Returns all the authenticated user's email addresses, both confirmed and unconfirmed.

Get user email details

Retrieves details about a specific email address for the authenticated user.

Get user permissions for repositories

Returns an object for each repository the caller has explicit access to, including their permission level.

Get user permissions for workspaces

Retrieves workspace memberships and permission levels for the authenticated user.

Get user workspaces

Tool to retrieve all workspaces accessible to the authenticated user.

Get workspace

Retrieves detailed information about a specific Bitbucket workspace.

Get Workspace Pull Requests by User

Tool to get all workspace pull requests authored by a specified user.

Search code in workspace

Tool to search for code in the repositories of the specified workspace.

List branches

Lists branches in a Bitbucket repository with optional server-side filtering by name pattern (BBQL) and sorting.

List commits

Tool to retrieve a page of commits from a Bitbucket repository.

List commits from revision

Tool to list commits starting from a specific revision in a Bitbucket repository.

List commits on master

Lists commits on the master branch of a Bitbucket repository.

List deployments

Lists deployments for a specified Bitbucket repository.

List issues in a repository

Lists issues in a Bitbucket repository with optional filtering by state, priority, kind, or assignee.

List pipelines

Tool to find pipelines in a Bitbucket repository.

List pull requests

Lists pull requests in a specified, accessible Bitbucket repository, optionally filtering by state (OPEN, MERGED, DECLINED).

List pull request tasks

Lists all tasks associated with a pull request in a Bitbucket repository.

List all public repositories

Retrieves a paginated list of all public repositories on Bitbucket.

List repository environments

List all deployment environments configured for a Bitbucket repository.

List repositories in workspace

Lists repositories in a specified Bitbucket workspace, accessible to the authenticated user, with options to filter by role or query string, and sort results.

List repository paths

Lists file and directory entries under a repository path at a given revision, with optional breadth-first recursion via max_depth for repository traversal and scanning.

List snippets

Returns all snippets accessible to the authenticated user.

List tags

Lists tags in a Bitbucket repository with optional server-side filtering by name pattern or commit hash (BBQL) and sorting.

List versions

Lists versions (milestones) in a Bitbucket repository's issue tracker.

List workspace members

Lists all members of a specified Bitbucket workspace; the workspace must exist.

List workspace projects

Lists projects in a specified Bitbucket workspace.

List workspaces

Lists Bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted.

Merge Pull Request

Tool to merge a Bitbucket Cloud pull request via the REST API.

Request Pull Request Changes

Tool to request changes on a pull request as the authenticated user.

Resolve pull request comment

Tool to resolve or reopen a pull request comment thread.

Search code in user repositories

Tool to search for code in the repositories of a specified user.

Update commit insight report

Create or update an insight report for a commit.

Update an issue

Updates an existing issue in a Bitbucket repository by modifying specified attributes; requires `workspace`, `repo_slug`, `issue_id`, and at least one attribute to update.

Update Pull Request

Tool to update an existing pull request's editable fields (e.

Update commit comment

Updates the contents of a comment on a commit.

Update commit report annotation

Creates or updates an individual annotation for a commit report.

Update team pipeline variable

Updates a team-level pipeline configuration variable in Bitbucket.

Update user pipeline variable

Updates a user-level pipeline variable for Bitbucket pipelines.

FRAMEWORKS

How to build Bitbucket MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Bitbucket MCP with ChatGPT

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Bitbucket MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Bitbucket MCP with Claude Agent SDK

Claude Code logo

Claude Code

Use Bitbucket MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Bitbucket MCP with Claude Cowork

Codex logo

Codex

Use Bitbucket MCP with Codex

Cursor logo

Cursor

Use Bitbucket MCP with Cursor

OpenClaw logo

OpenClaw

Use Bitbucket MCP with OpenClaw

Hermes logo

Hermes

Use Bitbucket MCP with Hermes

Google ADK logo

Google ADK

Use Bitbucket MCP with Google ADK

LangChain logo

LangChain

Use Bitbucket MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Bitbucket MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Bitbucket MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Bitbucket MCP with LlamaIndex

CrewAI logo

CrewAI

Use Bitbucket MCP with CrewAI

OpenCode logo

OpenCode

Use Bitbucket MCP with OpenCode

VS Code logo

VS Code

Use Bitbucket MCP with VS Code

FAQ

Frequently asked questions

The Composio Universal CLI is a single command-line interface that lets coding agents and developers interact with 1000+ SaaS applications. It handles authentication, tool discovery, action execution, and trigger setup — all from the terminal, without needing to configure MCP servers.

Any coding agent that can run shell commands works with the Composio CLI — including Claude Code, Codex, OpenCode, OpenClaw, and others. Once the CLI is installed, agents automatically discover and use the composio commands to interact with Bitbucket and other connected apps.

MCP servers require configuration and can be token-heavy for complex workflows. The CLI gives agents a direct, lightweight interface — no server setup needed. Agents simply call composio commands like any other shell tool. It's faster to set up, more reliable for multi-step tool chaining, and works natively with how coding agents already operate.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Bitbucket data and credentials are handled as safely as possible. You can also bring your own OAuth credentials for full control.

Start with Bitbucket.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Bitbucket tool your agent needs.Free to start.

Start building
Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREEBOOK A DEMO
agent.aiZoomLettaGleanHubSpotAWSWabi

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati
Harsha Gaddipati
Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya
Abhi Arya
Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave
Nirman Dave
CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu
Ryan Yu
Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola
Tomisin Jenrola
Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche
Jerome Leclanche
Co-Founder, Ingram Technologies