How do I connect Bitbucket to Operator?

You authorize Bitbucket once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Bitbucket without you signing in again.

Can my agent work with issues and pull requests in Bitbucket?

Yes. It can open and comment on issues, review pull requests, manage labels, and read project details when you ask. Teams use it to triage incoming work, draft release notes, and post a summary of what changed without leaving chat.

Do I need to write code or manage Bitbucket API keys?

No code and no API keys. You authorize Bitbucket through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.

Can my agent use Bitbucket together with my other apps?

Yes. The same agent reaches every app you connect, so it can move between Bitbucket and tools like GitHub, Supabase, Pagerduty in one job, reading from one and acting in another without you wiring anything between them.

← All integrations

Connect Bitbucket to OpenClaw on Operator.io

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

Developer Tools & DevOps105 actions

Try for free

Automate Bitbucket with AI

Hand Bitbucket to an OpenClaw agent running on Operator. You write what you want in a chat and it turns that into real Bitbucket actions like approve pull request, browse repository path, create a branch, without you opening the app.

Your agent reaches Bitbucket directly or through connectors like Composio MCP and Pipedream MCP, which handle the sign in and token refresh for you, so there is nothing to wire up and no API keys to paste.

What your agent can do with Bitbucket

Your agent can call any of these Bitbucket actions by name as part of a larger task. Ask for the outcome you want and it picks the right ones.

Approve Pull Request

Tool to approve a pull request as the authenticated user. Use when you need to formally approve changes in a pull request review process.

Browse repository path

Tool to retrieve content for a file path or browse directory contents at a specified revision in a Bitbucket repository. Use when you need flexible access to repository content - returns raw file data for files or paginated directory lis...

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. Supports top-level comments, threaded replies, and inline code comments. Use when providing feedback on a PR, replying to existing comments, or commenting on specific code lines.

Create commit report annotations

Adds multiple annotations to a commit report in bulk. Use when you need to add code analysis findings (vulnerabilities, code smells, bugs) to a report attached to a specific commit.

List commits from revision (POST)

Tool to list commits from a revision using POST method. Identical to GET endpoint but allows sending include/exclude parameters in request body to avoid URL length limits. Use when include/exclude parameters are too long for query strings.

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. Use when you need to add environment variables or configuration values that should be available to all pipelines within a team.

Create user pipeline variable

Creates a user-level pipeline variable for Bitbucket pipelines. Use when you need to create account-level configuration variables that can be used across all repositories owned by the user.

Delete commit comment

Permanently deletes a specific comment on a commit. Use when removing outdated, incorrect, or unwanted feedback 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). Use when removing outdated, incorrect, or unwanted feedback from a pull request.

Delete commit report annotation

Deletes a single annotation matching the provided ID from a commit report. Use when you need to remove a specific annotation from a code analysis 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. Use when you want to unsubscribe from notifications for a snippet.

Delete user pipeline variable

Permanently deletes a user-level pipeline configuration variable identified by its UUID. Use this to remove pipeline variables that are no longer needed at the account level.

Get branch

Retrieves detailed information about a specific branch in a Bitbucket repository. Use when you need to get branch metadata, the commit it points to, or verify a branch exists.

Get Commit Build Status

Get a specific build status for a commit in Bitbucket. Use when you need to check the status of a particular build/CI run for a commit.

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). Use when you need to enumerate files modified in a specific commit or commit range.

Get commit comment

Retrieves a specific comment from a commit by its ID. Use when you need to fetch details of a particular commit comment including content, author, timestamps, and inline location.

Get Commit Diff

Tool to retrieve the unified diff between two provided revisions or for a single commit in a Bitbucket repository. Use when you need to see the actual code changes in a commit or between two commits. Supports filtering by file path and v...

Get current user (v2)

Tool to retrieve complete profile information for the currently authenticated Bitbucket user. Use when you need comprehensive user details including account_id, username, nickname, and other profile fields.

Get deployment environment variables

Retrieves deployment environment level variables for a specific Bitbucket repository environment. Use when you need to view or audit environment-specific configuration variables for deployments.

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). Use when you need to discover available webhook event types for subscription or webhook configuration.

Get OpenID configuration for OIDC in Pipelines

Retrieves the OpenID Connect discovery configuration for Bitbucket Pipelines OIDC. Use when integrating Bitbucket Pipelines with resource servers (AWS, GCP, Vault) using OpenID Connect authentication. Returns issuer URL, JWKS URI, and su...

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. Use when you need to fetch details of a particular pull request comment including content, author, timestamps, and inline location.

Get Pull Request Commits

Tool to retrieve commits for a specified pull request. Use when reviewing the commit history of a PR or analyzing changes included in a pull request.

Get Pull Request Diff

Tool to fetch the unified diff for a Bitbucket pull request (follows 302 redirect to repository diff). Use when reviewing code changes in a PR. Supports optional truncation for large diffs via max_chars parameter.

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). Use when you need to enumerate files modified in a PR.

Get Repository Branching Model

Return the branching model as applied to the repository. Use when you need to understand the repository's branch workflow configuration, including development/production branches and branch type prefixes.

Get Repository Commit

Tool to retrieve detailed information about a specific commit in a Bitbucket repository. Use when you need to get complete commit details including author, message, date, parents, and related links.

Get commit comments

Retrieves all comments on a specific commit in a Bitbucket repository. Returns both global and inline code comments. Use when you need to view feedback, discussions, or notes left on a specific commit.

Get commit report

Returns a single report matching the provided ID from a commit. Use when you need to retrieve details of a specific analysis report (e.g., security scan, code coverage, test results, or bug report) for a commit.

Get Commit Reports

Tool to get reports linked to a specific commit. Use when you need to retrieve analysis results, test reports, security scans, or code coverage data associated with a commit.

Get commit report annotation

Returns a single annotation matching the provided ID from a commit report. Use when you need to retrieve details of a specific code analysis finding (e.g., vulnerability, code smell, or bug) identified in a commit.

Get commit statuses

Returns all build statuses (e.g., CI/CD pipeline results) for a specific commit. Use when you need to check build status, verify test results, or monitor deployment pipelines for a particular commit.

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). Use when you need to understand the repository's branch workf...

Get Repository Environment

Retrieve detailed information about a specific deployment environment in a Bitbucket repository. Use when you need to get environment configuration, deployment settings, or check environment properties like locks and restrictions.

Get file commit history

Returns a paginated list of commits that modified the specified file. Use when you need to track file changes over time, find who modified a file, or determine when a file was created or last changed.

Check if user voted for issue

Tool to check whether the authenticated user has voted for a specific issue in a Bitbucket repository. Use when you need to verify if the current user has already voted on an issue before attempting to vote or unvote.

Get Repositories Merge Base

Get the merge base (best common ancestor) between two commits in a Bitbucket repository. Use when you need to find the common ancestor commit between two branches or commits for comparison or merge operations.

Get specific pipeline

Retrieve a specified pipeline from a Bitbucket repository. Use when you need to get detailed information about a specific pipeline execution including its status, build number, and results.

Plus 57 more Bitbucket actions your agent can call.

How to connect Bitbucket

You authorize Bitbucket once from your dashboard. Operator holds the connection and refreshes the access tokens on its own, so your agent keeps working with Bitbucket without you signing in again. The same setup unlocks every other app your agent can reach, so you only do it once.

When you are ready, the get started guide walks through standing up your OpenClaw agent.

Common questions about Bitbucket

How do I connect Bitbucket to Operator?: You authorize Bitbucket once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Bitbucket without you signing in again.
Can my agent work with issues and pull requests in Bitbucket?: Yes. It can open and comment on issues, review pull requests, manage labels, and read project details when you ask. Teams use it to triage incoming work, draft release notes, and post a summary of what changed without leaving chat.
Do I need to write code or manage Bitbucket API keys?: No code and no API keys. You authorize Bitbucket through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.
Can my agent use Bitbucket together with my other apps?: Yes. The same agent reaches every app you connect, so it can move between Bitbucket and tools like GitHub, Supabase, Pagerduty in one job, reading from one and acting in another without you wiring anything between them.