Awesome Whatsapp
FreeNot checkedConnect WhatsApp to Claude, ChatGPT, Codex and AI agents: curated WhatsApp MCP servers, hosted services, Business API, risks, plus a free chat-export skill.
About
Connect WhatsApp to Claude, ChatGPT, Codex and AI agents: curated WhatsApp MCP servers, hosted services, Business API, risks, plus a free chat-export skill.
README
A curated, honest guide to connecting WhatsApp to Claude, ChatGPT, Codex, Cursor, n8n and other AI agents: MCP servers, hosted services, the official Business API, automation platforms, and the plain export route. Plus a free agent skill that reads WhatsApp chat exports.
Last checked: 22 October 2026. Every entry was checked against its own README or docs. Nothing here was tested with a live account unless stated.
Which route fits?
| You want | Start with |
|---|---|
| Your agent to read your personal chats, and you can run a server | A self-hosted MCP server |
| The same, without running anything yourself | A hosted service |
| A business number that talks to customers | The official Business API or an automation platform |
| A one-off summary of one chat, free, no connection at all | Export the chat and use the free export skill |
Before you connect a personal account, read Risks.
Want to sort or filter? tools.csv has every entry in one table; GitHub shows it with a search box.
Free skill: read a WhatsApp chat export
skills/whatsapp-chat-export lets
Claude Code, Codex or any skills-compatible agent read a WhatsApp .txt or
.zip export and turn it into a summary, events, tasks and follow-ups. No
account, API key or connector. Python 3 standard library only. It handles
iPhone and Android formats, 12- and 24-hour times, multi-line messages and
system lines.
npx skills add rosroyros/awesome-whatsapp-mcp
Or copy skills/whatsapp-chat-export/ into .claude/skills/ (Claude Code) or
.agents/skills/ (Codex). Then ask: "Read my exported WhatsApp chat and tell
me what I missed."
Self-hosted MCP servers (personal account)
These connect as a linked device, like WhatsApp Web. That route is unofficial; see Risks. The software is free, but something must stay online to receive messages: your own computer ($0, must stay on) or a small VPS (typically about $4–6 a month). Your message history stays with you.
| Name | What it is | Reads / sends | Where history is kept | Runs on | License |
|---|---|---|---|---|---|
| Automata | Open-source MCP server with per-chat permissions: read, write or no access for each chat. Also offered hosted (free for one connection). | Reads; sends only in chats you allow | Your server, or theirs if hosted | Your server, Docker (Evolution API + Postgres + Redis) | MIT |
| lharries/whatsapp-mcp | The original and best-known WhatsApp MCP server: Go bridge plus Python MCP server. No commits since July 2025. | Reads and sends | Your computer | Your computer | MIT |
| verygoodplugins/whatsapp-mcp | Maintained continuation of the original, with message search, media tools and optional transcription. | Reads and sends | Your computer | Your computer | MIT |
| felipeadeildo/whatsapp-mcp | Cloudflare deployment with searchable storage, multiple accounts and messaging tools. | Reads and sends | Your Cloudflare account | Your Cloudflare account (about $5/month per README) | GPL-3.0 |
| FelixIsaac/whatsapp-mcp-extended | Extended fork: group admin, webhooks, polls, recipient allowlist, selectable tool sets. | Reads and sends | Your computer | Your computer, Docker | MIT |
| BrOrlandi/whatsapp-mcp-local | Desktop app that exposes WhatsApp as a local MCP endpoint (uses wacli). | Reads and sends | Your computer | Your computer (must stay on) | MIT |
| BrOrlandi/whatsapp-mcp | Go gateway with a web panel and authenticated remote MCP. | Reads and sends | Your server | Your server | MIT |
| ericporres/whatsapp-mcp-server | Group-focused server: read, search, export and reply. | Reads and sends (groups) | Your machine, last 1,500 messages per group | Your computer or server | MIT |
| delltrak/wamcp | TypeScript server with two backends: WhatsApp Web or the Business Cloud API. | Reads and sends | Your server | Your server, Docker + Redis | MIT (per README) |
| WAHA MCP | Self-hosted WhatsApp HTTP API with a built-in MCP app and scoped keys. | Reads and sends | Your server | Your server, Docker | Apache-2.0 |
Hosted services (personal account)
Someone else runs the connection, so your messages pass through their servers. Still a linked device unless noted. "Where history is kept" comes from each service's own privacy policy or docs.
| Name | What it is | Reads / sends | Where history is kept | Runs on | Price |
|---|---|---|---|---|---|
| finereli/whatsapp-mcp | Hosted remote MCP for searching and reading your chats; open source (GitHub, MIT). | Read only | Theirs, encrypted at rest with a key tied to your account (maintainer) | Hosted | Free |
| wa2agent | Hosted MCP for personal agents; you choose which chats it can see. Disclosure: built by this list's maintainer. | Read only | Theirs: 30 days, encrypted with a key only your agent holds (privacy) | Hosted | Invite-only pilot; public demo |
| WhatSync | Hosted MCP with one endpoint for Claude, ChatGPT, Cursor and others; personal account or Business API; you pick the chats. | Reads; sends with permission | Theirs, period not stated | Hosted | Paid, from $19/month |
| Blueticks MCP | Hosted MCP connector for your WhatsApp number. | Reads and sends | Theirs, until you ask for deletion (policy) | Hosted | Paid, from $9/month, trial |
| Periskope MCP | Hosted MCP over a shared team inbox, chats and tickets. | Reads and sends | Theirs, while you use it; deleted within 30 days after (DPA) | Hosted | Paid, per user |
| Perisclaw | Hosted MCP with sign-in for your own WhatsApp number; published ChatGPT plugin, Claude custom connector, and Claude Code, Codex and Cursor. | Read only by default; reads and sends if you choose at sign-in (docs) | Theirs, period not stated; isolated and encrypted per user (privacy) | Hosted | Paid, from $15/month (alpha price), 7-day free trial (pricing) |
| Wassenger MCP | Hosted MCP for chats and messaging; linked device or Business API. | Reads and sends | Theirs, up to 1,000 messages per chat (FAQ) | Hosted | Paid, trial |
| 2Chat MCP | Hosted MCP for WhatsApp, SMS and calls; linked device or Business API. | Reads and sends | Theirs, while your account is open; deleted within 6 months of closing (policy) | Hosted | Paid, trial |
| Whapi.Cloud MCP | Local MCP adapter for Whapi's hosted gateway. | Reads and sends | Theirs: short-lived caches; media 30 days (help) | Hosted gateway, local adapter | Free sandbox (5 chats/month), then paid |
| GREEN-API MCP | Hosted MCP with messaging, notifications and groups. | Reads and sends | Theirs, period not stated (policy) | Hosted | Free developer plan (3 chats), then paid |
| Circles | Hosted remote MCP and HTTP API for your personal number; Claude, ChatGPT, Instinct, Cursor and others. You choose the chats it sees and set each to read only or read and send; voice notes transcribed (Hebrew, English); activity log of every agent request. | Reads; sends in chats you allow | Theirs, for the history window you choose (full, 90, 60 or 30 days); unlinking deletes it (privacy) | Hosted | Free for 2 chats (up to 3 months), then from $14.90/month; 14-day trial, no card |
Business API (official)
Uses Meta's WhatsApp Business Platform. It needs a verified Meta business and Meta's approval of your use case; reviews can take weeks and can be rejected. It is built for businesses messaging customers, not for reading your personal chats. Meta fees apply. Official does not mean Meta endorses a community project.
The 24-hour window: a business can only send free-form messages within 24 hours of the customer's last message. After that, only pre-approved templates go through. This is where agent replies usually break, so the table shows whether each tool handles it for you.
| Name | What it is | Reads / sends | Handles the 24-hour window? | Where history is kept | Runs on | Price / license |
|---|---|---|---|---|---|---|
| Meta WhatsApp Business Tools MCP | Meta's own MCP for account, number and template setup, plus test sends. Endpoint https://mcp.facebook.com/whatsapp_business_tools. |
Test sends; reading not verified | Not verified | Not a chat store | Meta | Not verified |
| Kapso MCP | Hosted MCP: send, read stored conversations, manage templates and webhooks. | Reads and sends (read-only by default) | Not documented for MCP; the inbox flags failed sends | Theirs, period not stated | Hosted | Free tier: 2,000 messages/month, one number |
| SendFromChat | Hosted Cloud API platform with remote MCP (Claude, ChatGPT, Claude Code, Cursor and others) and a REST API. | Reads and sends | Yes: checks the window and blocks free-form sends when closed; the assistant picks a template (docs) | Theirs, while your account is active; deleted within 30 days of workspace deletion (privacy) | Hosted | 30-day trial, then from $19/month plus Meta fees |
| FredShred7/whatsapp-mcp-server | Community Cloud API wrapper for messages, media and templates. Receiving needs webhooks. | Reads and sends | Not documented | In memory only, while it runs | Your computer or server | MIT |
Automation platforms
Business Cloud API unless noted. None of these documents automatic handling of the 24-hour window: n8n and Zapier leave the choice of template to you, and a Zapier send outside the window can fail while the Zap still shows success.
| Name | What it is | Reads / sends | Where history is kept | Runs on | Price / license |
|---|---|---|---|---|---|
| n8n | WhatsApp Business Cloud node and trigger; workflows can be exposed through n8n's MCP Server Trigger. | Reads and sends | Wherever your workflow saves it | Self-hosted or n8n Cloud | Free community edition; Cloud is paid |
| Zapier | WhatsApp Business workflows; MCP actions for sending. | Mostly sends; incoming via triggers | Zapier task history | Hosted | Paid plan for this integration |
| OpenClaw | Agent gateway with a native WhatsApp channel that routes messages to your agent and sends replies. Linked device. | Reads and sends | Your gateway | Self-hosted | MIT |
Manual route (free)
Export a chat from the WhatsApp app (Without media), then give the file to your assistant, or use the free export skill. Safe and free, but a one-time snapshot with no new messages.
Risks
- Account bans. WhatsApp says linking an account to unofficial clients violates its terms and can lead to restricted linking or temporary or permanent bans. Every linked-device tool above carries this risk, read-only ones included. No tool can guarantee "anti-ban". WhatsApp FAQ, Terms of Service.
- Business API and general AI assistants. From 15 January 2026, Meta's Business Solution Terms bar providers whose primary function is a general-purpose AI assistant. Exceptions apply in the EEA and Brazil, and on 9 June 2026 the European Commission ordered Meta to restore rivals' access while it investigates. Commission announcement.
- Prompt injection. Anyone who can message you can put instructions in a message your agent reads. Invariant Labs showed chat history and contacts leaking this way, including through a malicious second MCP server. Treat message text as data, and prefer read-only tools or send allowlists. Invariant Labs, Docker: MCP Horror Stories.
- Encryption ends at your agent. WhatsApp's end-to-end encryption does not protect messages after a connector or agent reads them. If your agent uses a cloud model, chat text goes to that model provider.
Contributing
Pull requests welcome. Please include a link to the project's own docs for each claim (read/send, hosting, price), and say if you build the tool. Projects that sell rented accounts, bulk messaging or engagement manipulation are not listed.
License
Installing Awesome Whatsapp
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/rosroyros/awesome-whatsapp-mcpFAQ
Is Awesome Whatsapp MCP free?
Yes, Awesome Whatsapp MCP is free — one-click install via Unyly at no cost.
Does Awesome Whatsapp need an API key?
No, Awesome Whatsapp runs without API keys or environment variables.
Is Awesome Whatsapp hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Awesome Whatsapp in Claude Desktop, Claude Code or Cursor?
Open Awesome Whatsapp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Gmail
Read, send and search emails from Claude
by GoogleSlack
Send, search and summarize Slack messages
by SlackRunbear
No-code MCP client for team chat platforms, such as Slack, Microsoft Teams, and Discord.
Discord Server
A community discord server dedicated to MCP by [Frank Fiegel](https://github.com/punkpeye)
Klavis AI
Open Source MCP Infra. Hosted MCP servers and MCP clients on Slack and Discord.
Work90210/APIFold
Turn any REST API into a hosted MCP server, with ready-made public servers for GitHub, Stripe, Slack, OpenAI, Notion and more.
by Work90210arikusi/deepseek-mcp-server
DeepSeek AI chat and reasoning with multi-turn sessions, function calling, thinking mode and cost tracking.
by arikusihashgraph-online/hashnet-mcp-js
Discover, register and chat with AI agents on the Hashgraph network via the Registry Broker.
by hashgraph-onlineprofullstack/mcp-server
Developer utilities: SEO optimization, document conversion, domain lookup, email validation, QR codes, weather data, social media posting and security scanning.
by profullstackWayStation-ai/mcp
Connect MCP hosts to apps such as Notion, Slack, Monday and Airtable.
by waystation-aiCompare Awesome Whatsapp with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All communication MCPs
