Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via
Connect Atlassian Bitbucket to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through. The atlassian bitbucket mcp server is what makes that connection.
A Node.js/TypeScript Model Context Protocol (MCP) server for Atlassian Bitbucket Cloud. Enables AI systems (e.g., LLMs like Claude or Cursor AI) to securely interact with your repositories, pull requests, workspaces, and code in real time.
Model Context Protocol (MCP) is an open standard for securely connecting AI systems to external tools and data sources. This server implements MCP for Bitbucket Cloud, enabling AI assistants to interact with your Bitbucket data programmatically.
The server ships on npm as @aashari/mcp-server-atlassian-bitbucket, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
bb_ls_workspaces — Lists available workspaces (query: str opt). Use: View accessible workspacesbb_get_workspace — Gets workspace details (workspaceSlug: str req). Use: View workspace informationbb_ls_repos — Lists repositories (workspaceSlug: str opt, projectKey: str opt, query: str opt, role: str opt). Use: Find repositoriesbb_get_repo — Gets repository details (workspaceSlug: str req, repoSlug: str req). Use: Access repo informationbb_search — Searches Bitbucket content (workspaceSlug: str req, query: str req, scope: str opt, language: str opt, extension: str opt). Use: Find code or PRsbb_ls_prs — Lists pull requests (workspaceSlug: str req, repoSlug: str req, state: str opt). Use: View open or merged PRsbb_get_pr — Gets PR details (workspaceSlug: str req, repoSlug: str req, prId: str req). Use: View PR details with diffsbb_ls_pr_comments — Lists PR comments (workspaceSlug: str req, repoSlug: str req, prId: str req). Use: View PR discussionsbb_add_pr_comment — Adds comment to PR (workspaceSlug: str req, repoSlug: str req, prId: str req, content: str req, inline: obj opt). Use: Add feedback to PRsbb_add_pr — Creates a PR (workspaceSlug: str req, repoSlug: str req, title: str req, sourceBranch: str req, targetBranch: str opt). Use: Create new PRsbb_add_branch — Creates a branch (workspaceSlug: str req, repoSlug: str req, newBranchName: str req, sourceBranchOrCommit: str opt). Use: Create a feature branchbb_clone_repo — Clones a repository (workspaceSlug: str req, repoSlug: str req, targetPath: str req). Use: Clone code locallyConfiguration is passed through the environment: ATLASSIAN_BITBUCKET_USERNAME, ATLASSIAN_BITBUCKET_APP_PASSWORD, ATLASSIAN_SITE_NAME, ATLASSIAN_USER_EMAIL, ATLASSIAN_API_TOKEN. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Atlassian Bitbucket's toolset — bb_ls_workspaces, bb_get_workspace, bb_ls_repos and 11 more — is a fair guide to whether it matches your workflow. It is maintained by askanuradha; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| bb_ls_workspaces | Lists available workspaces (query: str opt). Use: View accessible workspaces. |
| bb_get_workspace | Gets workspace details (workspaceSlug: str req). Use: View workspace information. |
| bb_ls_repos | Lists repositories (workspaceSlug: str opt, projectKey: str opt, query: str opt, role: str opt). Use: Find repositories. |
| bb_get_repo | Gets repository details (workspaceSlug: str req, repoSlug: str req). Use: Access repo information. |
| bb_search | Searches Bitbucket content (workspaceSlug: str req, query: str req, scope: str opt, language: str opt, extension: str opt). Use: Find code or PRs. |
| bb_ls_prs | Lists pull requests (workspaceSlug: str req, repoSlug: str req, state: str opt). Use: View open or merged PRs. |
| bb_get_pr | Gets PR details (workspaceSlug: str req, repoSlug: str req, prId: str req). Use: View PR details with diffs. |
| bb_ls_pr_comments | Lists PR comments (workspaceSlug: str req, repoSlug: str req, prId: str req). Use: View PR discussions. |
| bb_add_pr_comment | Adds comment to PR (workspaceSlug: str req, repoSlug: str req, prId: str req, content: str req, inline: obj opt). Use: Add feedback to PRs. |
| bb_add_pr | Creates a PR (workspaceSlug: str req, repoSlug: str req, title: str req, sourceBranch: str req, targetBranch: str opt). Use: Create new PRs. |
| bb_add_branch | Creates a branch (workspaceSlug: str req, repoSlug: str req, newBranchName: str req, sourceBranchOrCommit: str opt). Use: Create a feature branch. |
| bb_clone_repo | Clones a repository (workspaceSlug: str req, repoSlug: str req, targetPath: str req). Use: Clone code locally. |
| bb_get_commit_history | Gets commit history (workspaceSlug: str req, repoSlug: str req, revision: str opt, path: str opt). Use: View code history. |
| bb_get_file | Gets file content (workspaceSlug: str req, repoSlug: str req, filePath: str req, revision: str opt). Use: View specific file. |
{
"mcpServers": {
"bitbucket": {
"command": "npx",
"args": ["-y", "@aashari/mcp-server-atlassian-bitbucket"]
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| ATLASSIAN_BITBUCKET_USERNAME | Configuration value read at startup. | Optional |
| ATLASSIAN_BITBUCKET_APP_PASSWORD | Configuration value read at startup. | Optional |
| ATLASSIAN_SITE_NAME | Configuration value read at startup. | Optional |
| ATLASSIAN_USER_EMAIL | Configuration value read at startup. | Optional |
| ATLASSIAN_API_TOKEN | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.