WhatsApp Messaging API
Send WhatsApp messages from Claude. No Meta Business approval or WhatsApp Business account.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
whatsapp-messaging-api-mcpclaude mcp add whatsapp-messaging-api -e 'WHATSAPP_API_KEY=<your whatsapp_api_key>' -- npx -y whatsapp-messaging-api-mcp@1.0.3
{
"mcpServers": {
"whatsapp-messaging-api": {
"command": "npx",
"args": [
"-y",
"whatsapp-messaging-api-mcp@1.0.3"
],
"env": {
"WHATSAPP_API_KEY": "<your whatsapp_api_key>"
}
}
}
}
Variables d'environnement
WHATSAPP_API_KEYobligatoire secret RapidAPI key for the WhatsApp Messaging API. Free tier, no credit card.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
WhatsApp Messaging API — MCP Server
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.
Quick start
- Get a free API key from RapidAPI — no credit card.
- Add this to your MCP client config (Claude Desktop:
claude_desktop_config.json):{ "mcpServers": { "whatsapp": { "command": "npx", "args": ["-y", "whatsapp-messaging-api-mcp"], "env": { "WHATSAPP_API_KEY": "your-rapidapi-key" } } } } - 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 |
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
create_session→get_qr_code→ scan with WhatsApp (Settings → Linked Devices)get_session_statusuntil it reportsWORKINGcheck_contact_exists, thensend_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 | Your RapidAPI key. 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.
Local development
git clone https://github.com/jevil25/whatsapp-messaging-api-mcp.git
cd whatsapp-messaging-api-mcp
npm install
npm run dev # runs src/index.ts directly via tsx, no build step
npm run build # compile to dist/
npm test # boots the built server and drives a real MCP handshake
npm test needs no credentials — it passes a dummy key, which gets far enough to
list tools because nothing in the handshake makes an API call.
To point an MCP client at your local build, use "command": "node" with
"args": ["/absolute/path/to/dist/index.js"].
See DEVELOPING.md for the release process.
Links
- npm package
- MCP registry entry —
io.github.jevil25/whatsapp-messaging-api-mcp - WhatsApp Messaging API docs
License
MIT
Questions fréquentes
Qu'est-ce que WhatsApp Messaging API ?
Send WhatsApp messages from Claude. No Meta Business approval or WhatsApp Business account.
Comment installer WhatsApp Messaging API ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add whatsapp-messaging-api -e 'WHATSAPP_API_KEY=<your whatsapp_api_key>' -- npx -y whatsapp-messaging-api-mcp@1.0.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour WhatsApp Messaging API ?
Oui. Il attend WHATSAPP_API_KEY, à renseigner dans sa configuration.
WhatsApp Messaging API est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient WhatsApp Messaging API ?
Il est publié par jevil25. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.