# Circles: WhatsApp for your AI agents

> Circles: WhatsApp for your AI agents is a freemium MCP server for communication. Let Claude, ChatGPT or another AI read and reply in the WhatsApp chats you choose. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** whatsapp, Web, API
- **Website:** https://usecircles.app
- **MCP Registry name:** app.usecircles/whatsapp
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.usecircles.app/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "whatsapp": {
      "url": "https://app.usecircles.app/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/circles-whatsapp-for-your-ai-agents
