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-tom.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-tom.usebubbles.com/mcp"
  • Cursor: add it to your mcp.json as an HTTP MCP server.

The connector adds with no token to paste and no approval screen. Then just say “Sign me in to Bubbles.” The assistant walks the whole flow in the same conversation — it asks for your email, Bubbles emails you a sign-in code, you share it back, you pick or create a workspace, and the assistant’s Bubbles tools start working. No token to copy.