J
jevil25/whatsapp-messaging-api-mcp
Send WhatsApp messages from Claude, Cursor, or any MCP client.
updated 2026-11-16
View on GitHub ↗Direct link · no redirect page
We have neither an install command nor a public remote endpoint from this repository, so we do not print a config. A made-up one is worse than none. How each client wires MCP up →
- Star count
- 0 ★ · jevil25/whatsapp-messaging-api-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 3 sources · mcp
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
jevil25/whatsapp-messaging-api-mcp;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# WhatsApp Messaging API — MCP Server
Excerpted from the repository README (abridged)
Send WhatsApp messages from Claude, Cursor, or any MCP client. Create a session, scan a QR code, and send text, images and files — no Meta Business approval and no WhatsApp Business account required.
Wraps the WhatsApp Messaging API by Retention Stack.
## Quick start
1. Sign in at whatsapp-messaging.retentionstack.agency/start (free tier, no credit card) and copy a key from the console:
a session token (ch_live_...) for one number. Tools then need no session name.
an account key (ak_live_...) for every number on your account. Needed for create_session; pass session to the other tools.
2. Add this to your MCP client config (Claude Desktop: claude_desktop_config.json):
json
"mcpServers": {
"whatsapp": {
"command": "npx",
"args": ["-y", "whatsapp-messaging-api-mcp"],
"env": {
"WHATSAPP_API_KEY": "ch_live_your_session_token"
3. Restart the client. Ask it to create a WhatsApp session and show you the QR code.
Nothing to install or build — npx fetches the package on first run.
## Tools
| Tool | Description |
| list_sessions | List all sessions on this API key |
| create_session | Create a new session (account key only) |
| get_session_status | Check a session's current status |
| get_qr_code | Get the QR code to authenticate a session |
| request_pairing_code | Get an 8-digit pairing code instead of a QR |
| check_contact_exists | Check if a phone number is on WhatsApp before sending |
| send_text_message | Send a text message |
| send_image | Send an image via URL |
| send_file | Send a file (PDF, document) via URL |
## Typical flow
1. create_session → get_qr_code → scan with WhatsApp (Settings → Linked Devices)
2. get_session_status until it reports WORKING. If it reports PASSKEY_REQUIRED or PASSKEY_CONFIRMATION_REQUIRED, finish linking in the console: the passkey is signed in a browser, which an MCP client cannot do.
3. check_contact_exists, then send_text_message / send_image / send_file
Sessions stay authenticated between runs, so steps 1-2 are one-time per number.
## Configuration
| Variable | Required | Description |
| WHATSAPP_API_KEY | yes | A session token (ch_live_...) or account key (ak_live_...). The server exits on startup if it is missing. |
The key is read from the environment and sent only to the API host. It is never logged.
Upgrading from 1.x: earlier versions used a RapidAPI key, which no longer works. Replace it with a session token or account key from the console.
## Local development
bash
Wraps the WhatsApp Messaging API by Retention Stack.
## Quick start
1. Sign in at whatsapp-messaging.retentionstack.agency/start (free tier, no credit card) and copy a key from the console:
a session token (ch_live_...) for one number. Tools then need no session name.
an account key (ak_live_...) for every number on your account. Needed for create_session; pass session to the other tools.
2. Add this to your MCP client config (Claude Desktop: claude_desktop_config.json):
json
"mcpServers": {
"whatsapp": {
"command": "npx",
"args": ["-y", "whatsapp-messaging-api-mcp"],
"env": {
"WHATSAPP_API_KEY": "ch_live_your_session_token"
3. Restart the client. Ask it to create a WhatsApp session and show you the QR code.
Nothing to install or build — npx fetches the package on first run.
## Tools
| Tool | Description |
| list_sessions | List all sessions on this API key |
| create_session | Create a new session (account key only) |
| get_session_status | Check a session's current status |
| get_qr_code | Get the QR code to authenticate a session |
| request_pairing_code | Get an 8-digit pairing code instead of a QR |
| check_contact_exists | Check if a phone number is on WhatsApp before sending |
| send_text_message | Send a text message |
| send_image | Send an image via URL |
| send_file | Send a file (PDF, document) via URL |
## Typical flow
1. create_session → get_qr_code → scan with WhatsApp (Settings → Linked Devices)
2. get_session_status until it reports WORKING. If it reports PASSKEY_REQUIRED or PASSKEY_CONFIRMATION_REQUIRED, finish linking in the console: the passkey is signed in a browser, which an MCP client cannot do.
3. check_contact_exists, then send_text_message / send_image / send_file
Sessions stay authenticated between runs, so steps 1-2 are one-time per number.
## Configuration
| Variable | Required | Description |
| WHATSAPP_API_KEY | yes | A session token (ch_live_...) or account key (ak_live_...). The server exits on startup if it is missing. |
The key is read from the environment and sent only to the API host. It is never logged.
Upgrading from 1.x: earlier versions used a RapidAPI key, which no longer works. Replace it with a session token or account key from the console.
## Local development
bash
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/jevil25-whatsapp-messaging-api-mcp/)
- Source
- awesome · https://github.com/jevil25/whatsapp-messaging-api-mcp
- Browse by field
- MCP servers
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.