# whatsapi.sh

> whatsapi.sh is an MCP server for communication. Send WhatsApp messages from your own numbers, read chats and manage sending limits. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** whatsapp, API, Web
- **Website:** https://docs.whatsapi.sh/en/mcp
- **MCP Registry name:** sh.whatsapi/whatsapi
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http whatsapi https://api.whatsapi.sh/mcp
```

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

```sh
https://api.whatsapi.sh/mcp
```

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

```json
{
  "mcpServers": {
    "whatsapi": {
      "url": "https://api.whatsapi.sh/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "whatsapi": {
      "type": "http",
      "url": "https://api.whatsapi.sh/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "whatsapi": {
      "serverUrl": "https://api.whatsapi.sh/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.whatsapi.sh/mcp
```

Enter a Name (for example "whatsapi.sh"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "whatsapi": {
      "type": "http",
      "url": "https://api.whatsapi.sh/mcp"
    }
  }
}
```

## Tools

- `list_numbers`: Lists connected WhatsApp numbers with their connection status.
- `cancel_queued_message`: Cancels a message waiting in the send queue.

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

## Alternatives

- [API-Supp](https://ai-powered.com/mcp/api-supp): API-Supp is a paid MCP server for communication.
- [WASender WhatsApp](https://ai-powered.com/mcp/wasender-whatsapp): WASender WhatsApp is an MCP server for communication.
- [Whatsapp Tools](https://ai-powered.com/mcp/whatsapp-tools): Whatsapp Tools is an open-source MCP server for communication.
- [Turbo Notify: WhatsApp for AI agents](https://ai-powered.com/mcp/turbo-notify-whatsapp-for-ai-agents): Turbo Notify: WhatsApp for AI agents is an MCP server for communication.
- [Whatsmcp](https://ai-powered.com/mcp/whatsmcp): Whatsmcp is a freemium MCP server for communication.
- [Wagent](https://ai-powered.com/mcp/wagent): Wagent is an MCP server for communication.
- [Flow API (flowapi.pro) WhatsApp](https://ai-powered.com/mcp/flow-api-flowapi-pro-whatsapp): Flow API (flowapi.pro) WhatsApp is an MCP server for communication.
- [Wazap](https://ai-powered.com/mcp/wazap): Wazap is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/whatsapi-sh
