Bitbucket Toolkit

Superglue tools for Bitbucket: repos, branches, PRs, pipelines, and webhooks.

Quick Setup

1

Get your tool config

For each tool below, use the Download Config or Copy Config button (placeholders for now). You'll paste or save this JSON in your project.

2

Set up authentication

We use API keys, not OAuth, for this integration. Create an App Password in your Bitbucket Settings > App passwords. Add BITBUCKET_APP_PASSWORD, BITBUCKET_USERNAME, and optionally BITBUCKET_BASE_URL to your environment variables. Use Basic Auth with username and app password. See official docs: Bitbucket App Passwords

3

Install the superglue SDK

npm install @superglue/client

4

Run locally

Load the JSON config into the SDK and run the workflow with your env credentials. No API key required.

Drop-In Code Example

The SDK executes the downloaded JSON workflow locally using your environment's Bitbucket app password.

TypeScript 
import { SuperglueClient } from "@superglue/client";
import config from "./bitbucket_list_repos.json"; // or paste JSON string

const client = new SuperglueClient();

async function run() {
  const result = await client.run(config, {
    env: {
      BITBUCKET_APP_PASSWORD: process.env.BITBUCKET_APP_PASSWORD!,
      BITBUCKET_USERNAME: process.env.BITBUCKET_USERNAME!,
      BITBUCKET_BASE_URL: process.env.BITBUCKET_BASE_URL || "https://api.bitbucket.org/2.0",
      SUPERGLUE_REDIRECT_URI: process.env.SUPERGLUE_REDIRECT_URI || "https://app.superglue.cloud/api/auth/callback"
    }
  });
  console.log(JSON.stringify(result, null, 2));
}
run();

Tools in Toolkit

ToolActions

bitbucket_list_repos

List repos for a workspace.

👥 1,420 users

bitbucket_create_repo

Create a new repo in a workspace.

👥 1,108 users

bitbucket_get_repo

Fetch default branch and visibility.

👥 1,036 users

bitbucket_create_branch

Create a branch from a base ref.

👥 987 users

bitbucket_create_pull_request

Create PR from source → target.

👥 952 users

bitbucket_merge_pull_request

Merge an open PR (strategy options).

👥 903 users

bitbucket_comment_pull_request

Post a PR comment.

👥 876 users

bitbucket_get_pipeline_status

Retrieve latest pipeline runs.

👥 844 users

bitbucket_create_webhook

Register repo webhook for events.

👥 819 users

bitbucket_list_tags

List repo tags/releases.

👥 801 users