Claude App

Bubbles ships a remote MCP server that you add to Claude as a custom connector. Once connected and signed in, Claude can read your teams, bubbles, transcripts, and comments to answer questions like “summarize my standups this week” or “what were the action items from yesterday’s call?” — and it can send the Bubbles notetaker to record a meeting for you.

Two ways to use Bubbles from Claude

This page is the step-by-step connect guide. For the full tool list, schemas, and transcript chunking behavior, see the MCP Server reference.

Before you start

• The MCP endpoint you’ll add is your Bubbles API origin followed by /mcp:

  https://api.usebubbles.com/mcp

• Connecting takes no setup: Claude registers itself automatically (dynamic client registration) and runs the OAuth handshake for you. There is no token to paste. You sign in once in your browser and approve the access Claude is asking for, then you are returned to the conversation.

Add Bubbles in claude.ai

1. In claude.ai, open Settings → Connectors.

2. Click Add custom connector.

3. Give it a name (for example, Bubbles) and paste your MCP endpoint URL:

   https://api.usebubbles.com/mcp

4. Claude opens Bubbles in your browser. Sign in (or create an account) and approve the access Claude is asking for — you are returned to Claude with the connector ready.

5. In a chat, open the tools menu and enable Bubbles. Custom connectors are off by default per-conversation.

Sign in

Until you sign in, Claude can see the Bubbles tools but the ones that read your data return a short “not signed in” message with no data. There is no token to copy — sign-in happens in your browser, once:

1. Adding the connector opens Bubbles in your browser. Sign in, or create an account — the same page handles both, so you never have to say which you are.

2. Approve the access Claude is asking for. You are returned to your conversation, signed in on that connection.

3. If you’re new, the browser sign-up already walks you through the workspace step — joining one your email domain uses, or creating your own. You come back to Claude fully set up.

Your Bubbles workspace needs a paid plan

Approving access requires a workspace with paid-feature access. On a free workspace the approval step returns pro_required and the consent screen asks you to upgrade — upgrade in Bubbles, then connect again.

Once you’re signed in, the read tools return your data and join_meeting works. Claude remembers the connection, so a new conversation is already signed in — you don’t repeat this each time.

What Claude can do once connected

Claude gets six read-only tools plus one write tool (full schemas in the MCP reference):

• list_bubbles — find your meetings, recordings, and images (filterable by team, type, and date).
• search_bubbles — search your bubbles by keyword and get the most relevant ones back (matched on title, author name, and the AI-generated meeting notes — so a word discussed in a meeting finds it, even if it isn’t in the title).
• get_bubble — open one bubble’s details.
• get_bubble_transcript — read a diarized transcript (chunked for long meetings).
• get_bubble_comments — read a bubble’s comments.
• list_teams — list your teams, plans, and channels.
• join_meeting (write) — send the Bubbles notetaker to join and record a meeting by link.

The six list/get/search tools are read-only — Claude cannot create, edit, or delete anything with them, and it only ever sees bubbles you can read in the product. join_meeting is the only tool that acts: it uses the meetings:join permission your connection carries, and Claude uses it only when you explicitly ask it to record a meeting.

Directory listing status

Directory listing (optional)

Bubbles is not yet listed in the Claude connectors directory. A directory listing requires submission by a Claude Team/Enterprise organization Owner and Anthropic review (tracked as an owner action), but it is not needed to connect: Add custom connector using the URL above works for every claude.ai plan tier, including the Free tier (Free allows one custom connector; paid tiers allow several).

Troubleshooting

• “Couldn’t connect” / discovery fails — confirm you pasted your Bubbles MCP endpoint (https://api.usebubbles.com/mcp) exactly, and that it is reachable over the public internet (Claude connects from Anthropic’s cloud, not your device).
• Tools return “not signed in” — the browser sign-in and approval did not complete. Reconnect the connector, finish the Bubbles sign-in and approve access, and the read tools start returning your data on the same connection.
• Tools don’t show in a chat — enable the Bubbles connector in the chat’s tools menu; custom connectors are off by default per-conversation.
• A tool returns nothing after sign-in — you only see bubbles you can read in the product; the same access rules apply to the API and MCP.