Get started
Authentication
Every request acts as one person. Send an API key as a bearer token; AI apps and the CLI sign in with your approval instead.
Create an API key
- Open Settings, AI apps and devices in HeyBMO and choose Create key on the API keys card.
- Give it a name you will recognise later, such as the script or server that uses it.
- Copy the key straight away. It is shown once; HeyBMO keeps only a fingerprint of it.
Send it with every request
Authorization: Bearer hb_live_…Keep keys out of your code and your repository: read them from an environment variable such as HEYBMO_API_KEY. Anyone with a key can act as you, so revoke a key from Settings as soon as it is no longer needed or may have leaked. Signing out your other devices does not revoke API keys, but resetting your password deletes all of them.
AI apps and the CLI
Claude, ChatGPT and other apps connect with OAuth: you sign in to HeyBMO and approve the app. You can disconnect it at any time from Settings.
MCP serverheybmo login opens your browser to approve the computer. In CI or scripts, set HEYBMO_TOKEN to a key instead.
Spaces
Every call runs in a space. By default that is your personal space; send spaceId next to input to choose another one you belong to. account.spaces lists them.