# Bitbucket CLI for AI Agents ```json { "title": "Bitbucket CLI for AI Agents", "toolkit": "Bitbucket", "toolkit_slug": "bitbucket", "framework": "CLI", "framework_slug": "cli", "url": "https://composio.dev/toolkits/bitbucket/framework/cli", "markdown_url": "https://composio.dev/toolkits/bitbucket/framework/cli.md", "updated_at": "2026-05-06T08:02:53.779Z" } ``` ## 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 - [ChatGPT](https://composio.dev/toolkits/bitbucket/framework/chatgpt) - [OpenAI Agents SDK](https://composio.dev/toolkits/bitbucket/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/bitbucket/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/bitbucket/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/bitbucket/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/bitbucket/framework/codex) - [Cursor](https://composio.dev/toolkits/bitbucket/framework/cursor) - [VS Code](https://composio.dev/toolkits/bitbucket/framework/vscode) - [OpenCode](https://composio.dev/toolkits/bitbucket/framework/opencode) - [OpenClaw](https://composio.dev/toolkits/bitbucket/framework/openclaw) - [Hermes](https://composio.dev/toolkits/bitbucket/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/bitbucket/framework/google-adk) - [LangChain](https://composio.dev/toolkits/bitbucket/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/bitbucket/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/bitbucket/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/bitbucket/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/bitbucket/framework/crew-ai) ## TL;DR 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. ## Connect Bitbucket to CLI ### 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 ``` ## What is the Bitbucket MCP server, and what's possible with it? The Bitbucket MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Bitbucket account. It provides structured and secure access to your repositories, issues, and pull requests, so your agent can create branches, manage issues, review code, and handle repository operations for you. - Branch and repository management: Let your agent create new branches for feature work or initialize fresh repositories within your Bitbucket workspace—no manual setup required. - Automated issue tracking: Have your agent create, comment on, or delete issues to streamline team collaboration and bug tracking directly from your workflows. - Pull request automation: Empower your agent to open new pull requests for code review, ensuring changes are properly tracked and integrated. - File and snippet operations: Ask your agent to fetch specific files from any branch or commit, or to post comments on code snippets for contextual discussions. - User profile and workspace insights: Retrieve your Bitbucket user profile details on demand, making it easy to personalize and audit agent-driven actions. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `BITBUCKET_CREATE_BRANCH` | 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. | | `BITBUCKET_CREATE_ISSUE` | 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. | | `BITBUCKET_CREATE_ISSUE_COMMENT` | Create an issue comment | Adds a new comment with markdown support to an existing bitbucket issue. | | `BITBUCKET_CREATE_PULL_REQUEST` | 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. | | `BITBUCKET_CREATE_REPOSITORY` | 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. | | `BITBUCKET_CREATE_SNIPPET_COMMENT` | Create snippet comment | Posts a new top-level comment or a threaded reply to an existing comment on a specified bitbucket snippet. | | `BITBUCKET_DELETE_ISSUE` | Delete issue | Permanently deletes a specific issue, identified by its `issue id`, from the repository specified by `repo slug` within the given `workspace`. | | `BITBUCKET_DELETE_REPOSITORY` | Delete repository | Permanently deletes a specified bitbucket repository; this action is irreversible and does not affect forks. | | `BITBUCKET_GET_CURRENT_USER` | Get current user | Retrieves the profile information (uuid, display name, links, creation date) for the currently authenticated bitbucket user. | | `BITBUCKET_GET_FILE_FROM_REPOSITORY` | 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. | | `BITBUCKET_GET_PULL_REQUEST` | Get Pull Request | Get a single pull request by id with complete details. | | `BITBUCKET_GET_SNIPPET` | Get snippet | Retrieves a specific bitbucket snippet by its encoded id from an existing workspace, returning its metadata and file structure. | | `BITBUCKET_LIST_PULL_REQUESTS` | List pull requests | Lists pull requests in a specified, accessible bitbucket repository, optionally filtering by state (open, merged, declined). | | `BITBUCKET_LIST_REPOSITORIES_IN_WORKSPACE` | 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. | | `BITBUCKET_LIST_WORKSPACE_MEMBERS` | List workspace members | Lists all members of a specified bitbucket workspace; the workspace must exist. | | `BITBUCKET_LIST_WORKSPACES` | List workspaces | Lists bitbucket workspaces accessible to the authenticated user, optionally filtered and sorted. | | `BITBUCKET_UPDATE_ISSUE` | 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. | ## Supported Triggers None listed. ## Complete Code None listed. ## Conclusion - 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 ## How to build Bitbucket MCP Agent with another framework - [ChatGPT](https://composio.dev/toolkits/bitbucket/framework/chatgpt) - [OpenAI Agents SDK](https://composio.dev/toolkits/bitbucket/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/bitbucket/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/bitbucket/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/bitbucket/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/bitbucket/framework/codex) - [Cursor](https://composio.dev/toolkits/bitbucket/framework/cursor) - [VS Code](https://composio.dev/toolkits/bitbucket/framework/vscode) - [OpenCode](https://composio.dev/toolkits/bitbucket/framework/opencode) - [OpenClaw](https://composio.dev/toolkits/bitbucket/framework/openclaw) - [Hermes](https://composio.dev/toolkits/bitbucket/framework/hermes-agent) - [Google ADK](https://composio.dev/toolkits/bitbucket/framework/google-adk) - [LangChain](https://composio.dev/toolkits/bitbucket/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/bitbucket/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/bitbucket/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/bitbucket/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/bitbucket/framework/crew-ai) ## Related Toolkits - [Supabase](https://composio.dev/toolkits/supabase) - Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure. - [Codeinterpreter](https://composio.dev/toolkits/codeinterpreter) - Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms. - [GitHub](https://composio.dev/toolkits/github) - GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place. - [Ably](https://composio.dev/toolkits/ably) - Ably is a real-time messaging platform for live chat and data sync in modern apps. It offers global scale and rock-solid reliability for seamless, instant experiences. - [Abuselpdb](https://composio.dev/toolkits/abuselpdb) - Abuselpdb is a central database for reporting and checking IPs linked to malicious online activity. Use it to quickly identify and report suspicious or abusive IP addresses. - [Alchemy](https://composio.dev/toolkits/alchemy) - Alchemy is a blockchain development platform offering APIs and tools for Ethereum apps. It simplifies building and scaling Web3 projects with robust infrastructure. - [Algolia](https://composio.dev/toolkits/algolia) - Algolia is a hosted search API that powers lightning-fast, relevant search experiences for web and mobile apps. It helps developers deliver instant, typo-tolerant, and scalable search without complex infrastructure. - [Anchor browser](https://composio.dev/toolkits/anchor_browser) - Anchor browser is a developer platform for AI-powered web automation. It transforms complex browser actions into easy API endpoints for streamlined web interaction. - [Apiflash](https://composio.dev/toolkits/apiflash) - Apiflash is a website screenshot API for programmatically capturing web pages. It delivers high-quality screenshots on demand for automation, monitoring, or reporting. - [Apiverve](https://composio.dev/toolkits/apiverve) - Apiverve delivers a suite of powerful APIs that simplify integration for developers. It's designed for reliability and scalability so you can build faster, smarter applications without the integration headache. - [Appcircle](https://composio.dev/toolkits/appcircle) - Appcircle is an enterprise-grade mobile CI/CD platform for building, testing, and publishing mobile apps. It streamlines mobile DevOps so teams ship faster and with more confidence. - [Appdrag](https://composio.dev/toolkits/appdrag) - Appdrag is a cloud platform for building websites, APIs, and databases with drag-and-drop tools and code editing. It accelerates development and iteration by combining hosting, database management, and low-code features in one place. - [Appveyor](https://composio.dev/toolkits/appveyor) - AppVeyor is a cloud-based continuous integration service for building, testing, and deploying applications. It helps developers automate and streamline their software delivery pipelines. - [Backendless](https://composio.dev/toolkits/backendless) - Backendless is a backend-as-a-service platform for mobile and web apps, offering database, file storage, user authentication, and APIs. It helps developers ship scalable applications faster without managing server infrastructure. - [Baserow](https://composio.dev/toolkits/baserow) - Baserow is an open-source no-code database platform for building collaborative data apps. It makes it easy for teams to organize data and automate workflows without writing code. - [Bench](https://composio.dev/toolkits/bench) - Bench is a benchmarking tool for automated performance measurement and analysis. It helps you quickly evaluate, compare, and track your systems or workflows. - [Better stack](https://composio.dev/toolkits/better_stack) - Better Stack is a monitoring, logging, and incident management solution for apps and services. It helps teams ensure application reliability and performance with real-time insights. - [Blazemeter](https://composio.dev/toolkits/blazemeter) - Blazemeter is a continuous testing platform for web and mobile app performance. It empowers teams to automate and analyze large-scale tests with ease. - [Blocknative](https://composio.dev/toolkits/blocknative) - Blocknative delivers real-time mempool monitoring and transaction management for public blockchains. Instantly track pending transactions and optimize blockchain interactions with live data. - [Bolt iot](https://composio.dev/toolkits/bolt_iot) - Bolt IoT is a platform for building and managing IoT projects with cloud-based device control and monitoring. It makes connecting sensors and actuators to the internet seamless for automation and data insights. ## Frequently Asked Questions ### What is the Composio Universal CLI? 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. ### Which coding agents work with the Composio CLI? 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. ### How is the CLI different from using an MCP server for Bitbucket? 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. ### How safe is my Bitbucket data when using the Composio CLI? 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. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)