whatsapi.sh
Send WhatsApp messages from your own numbers, read chats and manage sending limits
- Platforms
- whatsapp, API, Web
- Runs
- Remotely
- Version
- 1.0.0
- Listing updated
- 3 days ago
Similar MCP servers
About whatsapi.sh
whatsapi.sh is an MCP server for communication. It runs as a hosted remote server, so there is nothing to install locally.
This connection is deliberately broad: it can send real messages, read stored chats, pair numbers, change their sending settings and configure webhooks and Supabase hooks, all on your account. The docs say there are no separate read-only or per-tool permissions, so they advise asking the agent to show the recipient and message for approval before every send.
whatsapi is described as an unofficial WhatsApp API, so WhatsApp may restrict or ban a number. A send queue and a daily limit on new conversations still apply through MCP, and a queued message counts as accepted rather than delivered. Queued messages can be cancelled with cancel_queued_message, and a send that times out should be retried only with the same idempotency key.
Sign-in is OAuth, which creates an API key named after the app that you can revoke from the dashboard. A device-code flow suits agents without a browser, and a plugin is available for Claude Code and Codex. Calls count against your account quota and sending limits.
Install
Run in a terminal
claude mcp add --transport http whatsapi https://api.whatsapi.sh/mcpAdd to Settings → Connectors → Add custom connector
https://api.whatsapi.sh/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"whatsapi": {
"url": "https://api.whatsapi.sh/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"whatsapi": {
"type": "http",
"url": "https://api.whatsapi.sh/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"whatsapi": {
"serverUrl": "https://api.whatsapi.sh/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://api.whatsapi.sh/mcpEnter a Name (for example "whatsapi.sh"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"whatsapi": {
"type": "http",
"url": "https://api.whatsapi.sh/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- list_numbers
- Lists connected WhatsApp numbers with their connection status.
- cancel_queued_message
- Cancels a message waiting in the send queue.
What it does
- Message sending
- Send WhatsApp messages from numbers you have paired.
- Chat reading
- Read stored chats and answer them.
- Number management
- List numbers with connection status and change sending settings.
- Queue control
- Cancel queued messages before they leave.
- Webhook setup
- Configure webhooks and Supabase hooks.
- Per-app API keys
- Each connected app gets its own revocable key.
Good for
- Reply to customer WhatsApp chats with agent help
- Send sign-in codes over WhatsApp
- Check which numbers are connected
- Cancel a queued message before it is sent
Pricing
Pricing unknown
Calls use your account quota and sending limits; prices not published here.
Prices change. Check docs.whatsapi.sh before you buy.
whatsapi.sh FAQ
Is the connection read-only?
No. It can send messages, pair numbers and change settings, and there are no per-tool permissions.
Is it an official WhatsApp API?
No. The docs call it unofficial and warn WhatsApp may restrict or ban your number.
How do I stop an app?
Revoke the app's key under API keys in the dashboard; removing the server from the app alone does not revoke it.
What if a send times out?
Check the chat and delivery receipts first, and retry only with the same idempotencyKey.
How do I add whatsapi.sh to Claude Code?
Run this command in your terminal: claude mcp add --transport http whatsapi https://api.whatsapi.sh/mcp
What are the best alternatives to whatsapi.sh?
The closest alternatives to whatsapi.sh are API-Supp, WASender WhatsApp, Whatsapp Tools, Turbo Notify: WhatsApp for AI agents and Whatsmcp.
Where this comes from
- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.