WhatsApp MCP
Hosted WhatsApp MCP server
One remote MCP endpoint for WhatsApp. Add it to Claude Code, Cursor, Codex, ChatGPT or Claude, sign in, and your AI can read, search and answer your WhatsApp chats with your approval.
Remote MCP over Streamable HTTP with OAuth sign-in. Nothing to install or keep running.
https://api.connectchats.com/mcp Hosted vs running your own WhatsApp MCP server
You can run an MCP server for WhatsApp yourself, or use a hosted one. Here is what changes.
ConnectChats (hosted)
- One URL. Nothing runs on your computer, so it keeps working when your laptop is closed.
- Sign in with OAuth from your MCP client. No tokens or session files to copy around.
- The same account and the same shared chats work in every MCP client you add it to.
- Sends are saved as drafts you approve, unless you turn on auto-send for a chat.
- Stored messages are encrypted with a key that only your passkey can unlock.
Running your own server
- You run the bridge and the server on your own machine or VPS, and keep both online.
- You handle the session, updates and reconnecting when WhatsApp drops the link.
- Each MCP client needs its own local setup, often a process started over stdio.
- You control the code and where the data lives.
- Approval, limits and prompt-injection safeguards are up to you.
The seven tools
Every ConnectChats MCP server exposes the same tools. Your AI picks the right one for what you ask.
list_linked_apps- Lists the chat apps you linked, such as WhatsApp, one line per account, with each account's connection state.
list_chats- Lists the chats you shared, unread first, with unread counts, the last message time and a preview.
read_messages- Reads messages in one shared chat: only what you have not read yet, or further back page by page.
search_messages- Searches message text across your shared chats, or within one chat app or one chat.
get_messages_to_summarize- Fetches the messages of a chat since you last read it, or since a time, so your AI can summarize them.
draft_reply- Saves a reply as a draft. Nothing is sent until you approve it in ConnectChats.
send_message- Sends right away only in chats with auto-send on. Anywhere else it saves a draft with a link to approve it.
Connect the WhatsApp MCP server to your client
Use the same server URL everywhere. The first time, your client opens a browser window so you can sign in.
Claude Code
Run this in your terminal, then type /mcp in Claude Code to sign in.
claude mcp add --transport http connectchats https://api.connectchats.com/mcp Cursor
Add this to ~/.cursor/mcp.json, or .cursor/mcp.json in a project, then sign in when Cursor asks.
{
"mcpServers": {
"connectchats": {
"url": "https://api.connectchats.com/mcp"
}
}
} Codex
Run this in your terminal, then run codex mcp login connectchats to sign in.
codex mcp add connectchats --url https://api.connectchats.com/mcp Approval first, and messages treated as untrusted
-
Sends need your approval
send_message saves a draft that you approve in ConnectChats. It sends right away only in chats where you turned on auto-send, and you can turn that off at any time.
-
Messages are untrusted content
Every message the server returns is wrapped and marked as written by other people, so your AI treats text from WhatsApp as data, not as instructions to follow.
-
You choose what is shared
Your AI only sees the WhatsApp chats you share in the dashboard. Stored messages are encrypted with a key that only your passkey can unlock.
WhatsApp support
ConnectChats links to your WhatsApp account as a linked device, the same way WhatsApp Web and the desktop app do. Your phone stays the main device, and you can unlink ConnectChats from it at any time. Direct chats and group chats both come through, and you choose which ones your AI app can see.
- Each linked chat starts with its last 200 messages, then every new message arrives as it is sent.
- Direct chats, groups and replies are supported. Photos, videos and voice notes show up as short text descriptions, with their captions.
- Your phone does not need to stay on, but WhatsApp unlinks companion devices when the phone has been offline for about 14 days. Open WhatsApp on your phone now and then to keep the link.
- ConnectChats uses one of the four linked device slots WhatsApp gives each account.
- The free plan links 2 chat apps and keeps messages for 30 days.
Questions
How do I start using the WhatsApp MCP server?
Add https://api.connectchats.com/mcp to your MCP client, sign in, link WhatsApp from your dashboard and share the chats you want your AI to see.
What is a WhatsApp MCP server?
MCP (Model Context Protocol) is how AI apps call outside tools. A WhatsApp MCP server gives an AI app like Claude or Cursor tools to list your WhatsApp chats, read and search messages, and draft replies.
Do I need to run anything locally?
No. ConnectChats is a remote MCP server at https://api.connectchats.com/mcp. Your MCP client connects over HTTPS and signs you in with OAuth.
Which MCP clients work?
Any client that supports remote MCP servers over Streamable HTTP, including ChatGPT, Claude, Grok, Manus, and Muse.
Can the server send messages on its own?
No. send_message saves a draft you approve, and it sends directly only in chats where you turned on auto-send.
How does it handle prompt injection?
Messages come back wrapped as untrusted content, and every tool tells the model to treat them as data. Outside chats where you turned on auto-send, nothing is sent without your approval.
Is it free?
Yes. The free plan links two chat apps and works in every supported MCP client. No card needed.
Does my phone need to stay online for WhatsApp to work?
No. ConnectChats keeps receiving messages while your phone is off or out of signal. WhatsApp does sign out linked devices if the phone stays offline for about 14 days, so open WhatsApp on it from time to time. If that happens, link it again from https://connectchats.com/app.
Can it read WhatsApp group chats?
Yes. Groups come through like direct chats, with each sender's name. Every group is listed in your dashboard, and you decide which ones are shared with your AI app.
Does it work with the WhatsApp Business app?
Yes. The WhatsApp Business app supports linked devices, so it links with the same QR code or pairing code. The WhatsApp Business Platform (the Cloud API used by large companies) is a different product and is not supported.
Related pages
Use the WhatsApp MCP server in
More about WhatsApp
MCP servers for other chat apps
Stop switching apps. Ask your AI instead.
Add ConnectChats in one click. Your first two chat apps are free.
Get started free