Bitbucket
Where to apply for a Bitbucket app password, which permissions it needs, and how to connect it to Nora.Bitbucket Cloud integrations let your agents read and write repositories, pull requests, and pipelines on bitbucket.org. Nora authenticates with HTTP Basic auth using your username plus an app password — Bitbucket’s narrowly-scoped, revocable alternative to your account password.
This guide covers Bitbucket Cloud (bitbucket.org). Bitbucket Data Center / Server uses a
different auth mechanism (HTTP access tokens) and is not supported by this integration today.
Where to apply for credentials
Bitbucket Cloud issues app passwords from your personal account settings:Bitbucket app passwords
Required permissions
When creating the app password, select these checkboxes:| Permission | Why |
|---|---|
| Account: Read | Connectivity test — Nora calls GET /2.0/user |
| Repositories: Read | Read repos, branches, files |
| Repositories: Write | Push commits, create branches |
| Pull requests: Write | Open and merge PRs |
| Pipelines: Read | List pipeline runs (if your agent inspects CI) |
Connect in Nora
Open the Bitbucket integration
From an agent’s detail page, open the Integrations tab and find Bitbucket in the catalog.
Paste username and app password
Enter your Bitbucket Username and paste the generated App Password (you only see this
value once; copy it before closing the Bitbucket page).
(Optional) Enter your workspace
Some agents need to know which workspace to default to. If your account belongs to multiple
Bitbucket workspaces, set the Workspace field to the slug — e.g.
acme-eng.Verify the connection
The Test button on the integration card calls the sameGET /2.0/user endpoint. Common failures:
- 401 Unauthorized — wrong username, wrong app password, or app password was revoked.
- 403 Forbidden — the app password lacks Account: Read.
Bitbucket username not configured— Nora can’t build the basic-auth header without a username; double-check the field.
MCP server
There is no official Bitbucket MCP server at the time of writing. Community servers exist on npm — Nora’s catalog will be updated when one stabilizes.Environment variables Nora injects
| Variable | Source |
|---|---|
BITBUCKET_APP_PASSWORD | App Password field |
BITBUCKET_USERNAME | Username field |
BITBUCKET_WORKSPACE | Workspace field (if set) |