# 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. Source: https://usecircles.app/en/help/connect-claude ยท Updated 2026-11-08 ## Before you start - **Your WhatsApp is linked to Circles.** If not, [start here](https://usecircles.app/start?lang=en); 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. 1. **Open Claude's connectors**: Sign in at [claude.ai](https://claude.ai/). Open *Customize*, then *Connectors*, select *+ Add* and choose *Add custom connector*. 2. **Paste the address**: Name it *Circles*, paste `https://app.usecircles.app/api/mcp` as the server address and select *Continue*. Keep the sign-in settings Claude detects, choose *Sign in now* and select *Add*. 3. **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*. 4. **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 1. **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`. 2. **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. 3. **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](https://usecircles.app/en/agents/claude-code) 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](https://usecircles.app/en/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](https://usecircles.app/en/security). ### 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](https://usecircles.app/en/agents/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. - [Getting started with custom connectors, support.claude.com](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) - [Use connectors to extend Claude, support.claude.com](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities) - [Connect Claude Code to tools via MCP, code.claude.com](https://code.claude.com/docs/en/mcp) ## Keep reading - [Claude and WhatsApp](https://usecircles.app/en/agents/claude): What to ask Claude once it is connected. - [Claude Code](https://usecircles.app/en/agents/claude-code): The same chats in your terminal. - [What Claude can reach](https://usecircles.app/en/security): Per-chat permissions, the activity log, disconnecting. - [WhatsApp AI on your phone](https://usecircles.app/en/guides/whatsapp-ai-on-mobile): Set up and use it with no computer. --- 14 days to try everything, free and with no credit card. Then you choose a plan by what you actually used. Start: https://usecircles.app/start?lang=en