Skip to content
MCP server

Circles: WhatsApp for your AI agents

Let Claude, ChatGPT or another AI read and reply in the WhatsApp chats you choose

Install
Pricing
Freemium
Platforms
whatsapp, Web, API
Runs
Remotely
Version
0.15.1
Listing updated
2 days ago

About Circles: WhatsApp for your AI agents

Circles: WhatsApp for your AI agents is a freemium MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.

Circles is built for people who already let an assistant see their email and calendar and want WhatsApp in the same place. You link a number the way you would WhatsApp Web, by scanning a QR code or entering a code under linked devices, then approve access for each AI and each chat.

The registry entry says it reads and writes by default, with no daily send quota. Voice notes are transcribed automatically in the language spoken, and the AI can open images, PDFs and other files from chats. It can also send messages and files and start new conversations, but only in chats where writing is open, and writing can be switched off per chat.

Each account connects from its own dedicated IP in the user's country. A hidden chat does not exist for the AI, an activity log shows what was read, sent or blocked, and disconnecting deletes the stored chats, messages, files and contacts. Circles notes that it connects as an unofficial linked device, which WhatsApp's terms do not allow, so no one can promise the number will never be disconnected.

Install

Run in a terminal

claude mcp add --transport http whatsapp https://app.usecircles.app/api/mcp

Add to Settings → Connectors → Add custom connector

https://app.usecircles.app/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "whatsapp": {
      "url": "https://app.usecircles.app/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "whatsapp": {
      "type": "http",
      "url": "https://app.usecircles.app/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "whatsapp": {
      "serverUrl": "https://app.usecircles.app/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "whatsapp": {
      "type": "http",
      "url": "https://app.usecircles.app/api/mcp"
    }
  }
}

What it does

Chat-level access
Only the AI you approve gets in, and only to chats you open to it; hidden chats do not exist for it.
Voice note transcription
Voice messages are transcribed in the language they were spoken and read like any other message.
Files and images
The AI can open photos, PDFs and other files exactly as they arrived in a chat.
Send and reply
The AI can reply, send files and start conversations in chats where writing is enabled.
Activity log
See what the AI read, sent and what was blocked, labelled with the agent name.
Retention controls
Keep only the last 30 days, mark a chat never to be stored, or disconnect to delete everything.

Good for

  • Ask what you missed in a parents' group today
  • Have a voice message from a family member summarised
  • Find a contract an accountant sent and summarise its clauses
  • List what you promised to answer this week
  • Reply to a contact from the AI with a message you dictate

Pricing

Freemium

Free: 2 chats; Plus 39 ILS/mo (10 chats); Pro 79 ILS/mo (all allowed chats); 14-day full trial

Prices change. Check usecircles.app before you buy.

Circles: WhatsApp for your AI agents FAQ

Which AIs work with it?

Claude, ChatGPT, Claude Code, Instinct and any AI that connects over MCP or the API.

Does it need a credit card?

No. The first 14 days include all chats without a card; a card is only needed when you choose Plus or Pro.

What does it cost?

Free covers 2 chats for up to 3 months from linking, Plus is 39 shekels a month for 10 chats, and Pro is 79 shekels a month for every chat you allow.

Can WhatsApp disconnect my number?

It might. Circles connects as an unofficial linked device and says nobody can guarantee WhatsApp will not disconnect it, though it sends one message at a time and never bulk messages.

Does the AI subscription come included?

No. The Claude or ChatGPT plan is separate, and Circles works with free accounts when the AI supports connectors.

Is Circles: WhatsApp for your AI agents free?

Circles: WhatsApp for your AI agents has a free plan, with paid plans for more usage or features.

How do I add Circles: WhatsApp for your AI agents to Claude Code?

Run this command in your terminal: claude mcp add --transport http whatsapp https://app.usecircles.app/api/mcp

What are the best alternatives to Circles: WhatsApp for your AI agents?

The closest alternatives to Circles: WhatsApp for your AI agents are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

Alternatives to Circles: WhatsApp for your AI agents

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity