# How to connect Bitbucket MCP with VS Code ```json { "title": "How to connect Bitbucket MCP with VS Code", "toolkit": "Bitbucket", "toolkit_slug": "bitbucket", "framework": "VS Code", "framework_slug": "vscode", "url": "https://composio.dev/toolkits/bitbucket/framework/vscode", "markdown_url": "https://composio.dev/toolkits/bitbucket/framework/vscode.md", "updated_at": "2026-05-06T08:02:53.779Z" } ``` ## Introduction ### How to connect Bitbucket MCP with VS Code VS Code is the most popular code editor out there. With its recent AI makeover, it can do more than just help you write code. You can connect your applications to it and let LLMs automate many of the mundane tasks in your workflow. In this guide, I will explain how to connect Bitbucket with VS Code in the most secure and robust way possible via Composio. ## 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) - [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) - [CLI](https://composio.dev/toolkits/bitbucket/framework/cli) - [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 ### Why use Composio? Composio provides: - Access to 1,000+ managed apps from a single MCP endpoint. This makes it convenient for agents to run cross-app workflows. - Programmatic tool calling. Allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling. - Large tool response handling outside the LLM context. This minimizes context bloat from large tool responses. - Dynamic just-in-time access to thousands of tools across hundreds of apps. Composio loads the tools your agent needs, so LLMs are not overwhelmed by tools they do not need. ## Connect Bitbucket to VS Code ### Integrate Bitbucket MCP with VS Code ### 1. Install with one click Click the button below to add Composio to VS Code. You will be prompted to authorize. This requires VS Code 1.99+ with GitHub Copilot. [+Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22composio%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fconnect.composio.dev%2Fmcp%22%7D) ### 2. Or add manually Open or create .vscode/mcp.json in your project root and add the following configuration: ```bash { "servers": { "composio": { "type": "http", "url": "https://connect.composio.dev/mcp" } } } ``` ## 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. ## Creating MCP Server - Stand-alone vs Composio SDK Once connected, VS Code can access the Bitbucket MCP server via Composio to run the app actions you authorize, directly from your coding workflow. ## Complete Code None listed. ## Conclusion ### Way Forward Now that Bitbucket is connected, extend your setup by connecting the other apps you already use every day, so your agent can run true cross-app workflows end to end. - Connect Calendar to turn threads into scheduled meetings automatically. - Connect Slack or Teams to post summaries, approvals, and alerts where your team works. - Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs. - Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps. - Connect HubSpot or Salesforce to log customer context, update records, and draft follow-ups. Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single MCP endpoint, your agent can coordinate multiple tools safely and reliably in one conversation. ## 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) - [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) - [CLI](https://composio.dev/toolkits/bitbucket/framework/cli) - [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 are the differences in Tool Router MCP and Bitbucket MCP? With a standalone Bitbucket MCP server, the agents and LLMs can only access a fixed set of Bitbucket tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Bitbucket and many other apps based on the task at hand, all through a single MCP endpoint. ### Can I use Tool Router MCP with VS Code? Yes, you can. VS Code fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Bitbucket tools. ### Can I manage the permissions and scopes for Bitbucket while using Tool Router? Yes, absolutely. You can configure which Bitbucket scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do. ### How safe is my data with Composio Tool Router? 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. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)