Skip to content
Bubbles API

Bubbles API

Build on Bubbles — read your teams, bubbles, transcripts, and comments; subscribe to events; connect an AI agent over MCP.
Quickstart API Reference

Get started

New here? The Quickstart takes you from zero to your first authenticated API call in three steps. The Bubbles public API is a REST API served under a versioned /v1 prefix; every example uses a BASE_URL placeholder you set to your API origin, so nothing hardcodes a host.

Quickstart Create an API key, set your base URL, and make your first call in a few minutes.
Authentication Personal access tokens and the full OAuth 2.1 journey (DCR, PKCE, consent, refresh rotation).
API Reference Every v1 endpoint, request/response examples, pagination, error types, and rate limits.
Webhooks Subscribe to events, verify HMAC signatures, and understand delivery/retry behaviour.
MCP Server Connect Claude, ChatGPT, Claude Code, or Cursor to your Bubbles data over the Model Context Protocol.
Integrations & apps Add Bubbles to Claude and ChatGPT, or use the Slack and Zapier integrations.

Start with an AI agent — no code

Not a developer? You can connect Bubbles to your AI assistant and have it sign you in — no code. The best way is to add the Bubbles connector to any MCP-capable assistant (Claude, ChatGPT, Claude Code, or Cursor). Add this connector URL:

https://api.usebubbles.com/mcp
  • claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → paste the URL.
  • ChatGPT: Settings → Connectors → Advanced → Developer mode, then Add custom connector → paste the URL.
  • Claude Code: claude mcp add --transport http bubbles "https://api.usebubbles.com/mcp"
  • Cursor: add it to your mcp.json as an HTTP MCP server.

There is no token to paste. Adding the connector opens Bubbles in your browser, where you sign in (or create an account) and approve the access the assistant is asking for. Approve it and you are returned to your conversation with the Bubbles tools already working — just ask for what you need, or say “What can you do with Bubbles?” to see the options.

Approving access requires a Bubbles workspace with paid-feature access; on a free workspace the approval step asks you to upgrade first.