Help
Connect Circles to Claude
One address, added once to your Claude account, and one approval on Circles' page. This page has the steps for each way into Claude, the questions people ask, and a fix for each problem we have seen.
Add https://app.usecircles.app/api/mcp to Claude as a custom connector, on claude.ai or in the Claude desktop app, and approve on Circles' page. The connector belongs to your Claude account, so the desktop app and the Claude phone app see it too. On a phone, add it at claude.ai in the browser. On Team and Enterprise, an owner adds Circles for the organization first. Claude Code is set up separately, with one command. Claude's side as checked on 2026-11-08.
Updated
Before you start
- Your WhatsApp is linked to Circles. If not, start here; it takes about a minute.
- A Claude account. Every Claude plan can add a custom connector: Free, Pro, Max, Team and Enterprise. On Free, Claude allows one custom connector.
- The address to paste:
https://app.usecircles.app/api/mcp. There is no key and no code to copy for Claude.
On the web, at claude.ai
This is the main path, and the one to use on a phone too. Menu names are Claude's and may move: check in Claude.
Open Claude's connectors
Sign in at claude.ai. Open Customize, then Connectors, select + Add and choose Add custom connector.
Paste the address
Name it Circles, paste
https://app.usecircles.app/api/mcpas the server address and select Continue. Keep the sign-in settings Claude detects, choose Sign in now and select Add.Approve on Circles' page
A Circles page opens. If it asks you to sign in, type your WhatsApp number and tap the link Circles sends you on WhatsApp, in the same browser. Reading and sending are ticked; untick sending for a read-only connection. Select Allow access.
Ask Claude
Start a new conversation. If Circles is off, turn it on under +, then Connectors. Ask: "What is new in my WhatsApp since this morning?"
In the Claude desktop app, Mac and Windows
The desktop app uses the same steps as the web: Customize, Connectors, + Add, Add custom connector. A connector you already added at claude.ai is there in the desktop app too, so you only add it once. Cowork in the desktop app reaches the same connectors.
On iPhone and Android
Add Circles at claude.ai in your phone's browser (Safari or Chrome), signed in to the same Claude account as the app. Claude says adding connectors in its phone app is still in beta, and the web and desktop are the main way. Once it is added, Circles is in the Claude app on iPhone and Android the next time you open it.
If a link opens the Claude app instead of the website, type claude.ai into the browser yourself. If the add option is missing on the phone, ask the browser for the desktop site, or add it from a computer.
Claude Team and Enterprise
An owner adds Circles once
On Team, an Owner or Primary Owner; on Enterprise, also anyone whose role can manage connectors. In Organization settings, Connectors, select Add, then Custom, then Web, and paste
https://app.usecircles.app/api/mcp.Each member connects their own WhatsApp
In Customize, Connectors, find Circles and select Connect. Each person approves on Circles' page with their own number, so each sees only their own chats.
No owner nearby?
On Team, members can ask for a connector from the connectors screen. On Enterprise that request is off until an owner turns it on. Check in Claude.
Claude Code
In a terminal, run claude mcp add --transport http circles https://app.usecircles.app/api/mcp, then type /mcp in Claude Code and sign in to Circles. Claude Code and WhatsApp has the token way too.
Claude Code's connection stays in Claude Code on that computer. It does not appear in claude.ai, the desktop chat or the phone app. The other way round works: if you sign in to Claude Code with your Claude account, the connectors added at claude.ai are there in Claude Code. So to use Circles everywhere, add it once at claude.ai.
Read or send, disconnecting and connecting again
- Read only or read and send. You choose on Circles' approval page. To change it later, connect again and tick what you want. Any single chat can also be set to read only or hidden in the Circles app, whatever the connection allows.
- Disconnect. In the Circles app, on the agents page, disconnect Claude: it loses access at once. In Claude, remove the connector under Customize, Connectors.
- Connect again after disconnecting. In Claude, select Connect on Circles (or remove it and add it again), and approve on Circles' page.
- Two Claude accounts. Each Claude account adds Circles and approves on its own, and each shows as its own agent in Circles.
- More than one WhatsApp number. One WhatsApp number per Circles account for now.
Questions and answers
Which Claude plans can connect Circles?
All of them: Free, Pro, Max, Team and Enterprise. On Free, Claude allows one custom connector. On Team and Enterprise, an owner adds Circles for the organization first.
What does it cost?
Claude's plan is Claude's. Circles has its own plans: Free for 2 chats for up to 3 months, Plus for up to 10 chats at $14.90 a month, and Pro for every chat you allow at $29.90 a month, with 14 days of Pro free first. Pricing.
What can Claude see?
Only the chats open to agents in Circles, with their messages, voice notes as text, files and photos. Hidden chats do not exist for Claude, and your chat with the Circles number is never reachable.
Can Claude send messages as me?
Yes, if you left sending ticked on the approval page, and only in chats open for sending. Each send is one message, never retried automatically, and every send is in your activity log.
How do I hide a chat from Claude?
In the Circles app, on the Chats page, set it to hidden. It is gone for Claude right away.
Do I need an API key?
No. Claude registers itself with Circles and you approve on Circles' page. Claude Code can also use a token, if you prefer one.
Is it private?
Claude reaches Circles over encrypted HTTPS, sees only what you opened, and every request it makes is in your activity log. How Circles handles your chats.
How do I disconnect?
In the Circles app, disconnect Claude on the agents page. Its access ends at once. You can also remove the connector in Claude.
When something goes wrong
I can't find where to add a connector
In the Claude phone app, use claude.ai in the browser instead. On Free, Claude allows one custom connector: remove the other one, or check your plan in Claude. On Team or Enterprise, an owner adds Circles first.
My organization hasn't allowed it
Ask an owner to add Circles under Organization settings, Connectors, with the address above. On Team you can also request it from the connectors screen. Then select Connect on Circles.
The Circles page keeps asking me to sign in
Open the WhatsApp sign-in link in the same browser as Claude. On a phone, copy the link into Safari or Chrome. On a computer, open it from WhatsApp on that computer. Then select Allow access.
Claude is added, but it never reads my chats
If the Circles app says Claude didn't finish connecting, the approval never reached Claude: in Claude, remove Circles and add it again, choose Sign in now, and approve. If it says Never connected, Claude has not asked yet: turn Circles on under + and Connectors in a new conversation, and ask one question.
The Claude app says Circles isn't connected
If you connected Circles in Claude Code, that connection lives in Claude Code only. Add Circles at claude.ai as well, and it reaches the desktop and phone apps.
Claude says it can't see a chat
That chat is hidden, or outside your plan: Free reaches 2 chats you pick. Open it on the Chats page in the Circles app, or choose Plus or Pro for more. Claude can read every chat that is open.
Older messages are missing
History arrives in about 10 to 15 minutes after linking. New messages are there at once. Ask again in a few minutes.
Claude says my WhatsApp is disconnected
WhatsApp unlinked Circles' device. Link it again in the Circles app with a new code. Claude's connector stays as it is.
I don't have a computer
Everything works from the phone: link WhatsApp, add Circles at claude.ai in the browser, then ask in the Claude app. For asking inside WhatsApp itself, Instinct connects with one tap.
Write to Circles Customer Service
On WhatsApp, the Circles number knows your account and can send you the right link. Tell it which Claude you use (web, desktop, phone or Claude Code) and what you see.
Sources
Claude's side as described on Anthropic's help pages on 2026-11-08. Claude changes its menus; when a step looks different, follow what Claude shows.
Your email is already with your AI. Now connect WhatsApp.
14 days to try everything, free and with no credit card. Then you choose a plan by what you actually used.