Integrates Cursor IDE with Bitbucket Cloud, allowing fetching of repository information, detailed repository data, commit history, commit counts, and latest commit information from Bitbucket workspaces.
Used as the runtime environment for the MCP server, enabling execution of the JavaScript code that powers the Bitbucket integration.
The MCP server is implemented in TypeScript, providing type safety and modern language features for the server implementation.
Bitbucket MCP
A Model Context Protocol (MCP) server that integrates Cursor IDE with Bitbucket Cloud, allowing you to fetch repository information and commit data directly from your Bitbucket workspace.
Features
List Repositories: Fetch all repositories from your Bitbucket workspace
Repository Details: Get detailed information about specific repositories
Commit Information: Retrieve commit history and latest commit details
Commit Counts: Get total commit counts per repository
Latest Commit Data: Fetch the most recent commit date, author, and message for each repository
Workspaces: List all available workspaces.
Pull Requests: Create, view, list, and update pull requests.
Projects: View project details and list default reviewers.
Branch Restrictions: Manage branch restrictions for projects and repositories.
Commits: Retrieve individual commits and lists of commits.
Prerequisites
Node.js 18 or higher
npm or yarn
A Bitbucket Cloud account
Bitbucket App Password (for authentication)
Setup
1. Install Dependencies
2. Build the Project
3. Create Atlassian API token*
if you already have a token for Jira or Confluence, you can reuse it *
Go to your Bitbucket account settings
Navigate to "App passwords" under "Access management"
Instead of clicking "Create app password" (outdated), navigate to "Go to API tokens"
Create an API token
Give it a descriptive name (e.g., "Cursor MCP Integration")
Select expiry date
Copy the generated token
4. Configure Environment Variables
Create a .env
file in the project root:
Note: The workspace name is typically your username or organization name. You can find it in your Bitbucket URLs (e.g., https://bitbucket.org/workspace_name/
).
5. Add to Cursor MCP Configuration
Add the following configuration to your Cursor MCP settings:
6. Restart Cursor
After adding the configuration, restart Cursor IDE to load the MCP server.
Usage
Once configured, you can use the following tools in Cursor:
Workspaces
bitbucket_list_workspaces
Repositories
bitbucket_list_repositories
bitbucket_get_repository_details
Commits
bitbucket_list_commits
bitbucket_get_commit
Pull Requests
bitbucket_list_pull_requests
bitbucket_get_pull_request
bitbucket_create_pull_request
bitbucket_update_pull_request
Projects
bitbucket_get_project
bitbucket_list_default_reviewers
Branch Restrictions
bitbucket_list_branch_restrictions
bitbucket_get_branch_restriction
bitbucket_update_repository_branching_model_settings
bitbucket_update_project_branching_model_settings
Available Tools
Workspaces
list_workspaces: Lists all workspaces accessible by the current user.
Repositories
list_repositories: Lists all repositories in the configured Bitbucket workspace.
get_repository_details: Get detailed information about a specific repository including latest commit info.
Commits
list_commits: Get commit information for a specific repository.
get_commit: Get a single commit by its hash.
Pull Requests
list_pull_requests: List all pull requests in a repository.
get_pull_request: Get a single pull request by its ID.
create_pull_request: Create a new pull request. //Beta version - untested
update_pull_request: Update an existing pull request. //Beta version - untested
Projects
get_project: Get a single project by its key.
list_default_reviewers: List default reviewers for a project.
Branch Restrictions
list_branch_restrictions: List all branch restrictions for a repository.
get_branch_restriction: Get a single branch restriction by its ID.
update_repository_branching_model_settings: Update the branching model configuration for a repository. //Beta version - untested
update_project_branching_model_settings: Update the branching model configuration for a project. //Beta version - untested
Development
Running in Development Mode
Building
Project Structure
Troubleshooting
Authentication Issues
Verify your Bitbucket username and app password are correct
Ensure the app password has the correct permissions (Repositories: Read)
Check that the workspace name is correct
Connection Issues
Verify your internet connection
Check if Bitbucket API is accessible from your network
Ensure the MCP server is running (check Cursor's MCP logs)
Repository Not Found
Verify the repository name is correct (use the repo slug, not display name)
Ensure you have access to the repository
Check that the repository exists in the specified workspace
MCP Server Not Loading
Verify the path to
dist/index.js
is correct in your Cursor configurationEnsure Node.js is installed and accessible from the command line
Check Cursor's MCP server logs for error messages
Security Notes
Keep your Bitbucket app password secure and never commit it to version control
Use environment variables or secure configuration management for credentials
The app password should only have the minimum required permissions
Consider rotating your app password regularly
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
License
MIT License - see LICENSE file for details
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A Model Context Protocol server that integrates Cursor IDE with Bitbucket Cloud, allowing developers to fetch repository information and commit data directly from their Bitbucket workspace.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.Last updated -21
- AsecurityAlicenseAqualityA powerful Model Context Protocol framework that extends Cursor IDE with tools for web content retrieval, PDF processing, and Word document parsing.Last updated -813MIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for Cursor IDE that simplifies the installation and configuration of other MCP servers.Last updated -36770MIT License