WhatsApp Cloud MCP Server
by codespario.github.codespar/mcp-whatsapp-cloudv0.2.2
MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API
context tax
queued
security
queued
cold start
queued
freshness
Active13d ago
Install WhatsApp Cloud MCP server
Install in Claude Code
claude mcp add whatsapp-cloud -e WHATSAPP_ACCESS_TOKEN='<whatsapp-access-token>' -e WHATSAPP_PHONE_NUMBER_ID='<whatsapp-phone-number-id>' -e WHATSAPP_BUSINESS_ACCOUNT_ID='<whatsapp-business-account-id>' -- npx -y @codespar/mcp-whatsapp-cloudInstall in Cursor
{
"mcpServers": {
"whatsapp-cloud": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-whatsapp-cloud"
],
"env": {
"WHATSAPP_ACCESS_TOKEN": "<whatsapp-access-token>",
"WHATSAPP_PHONE_NUMBER_ID": "<whatsapp-phone-number-id>",
"WHATSAPP_BUSINESS_ACCOUNT_ID": "<whatsapp-business-account-id>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"whatsapp-cloud": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-whatsapp-cloud"
],
"env": {
"WHATSAPP_ACCESS_TOKEN": "<whatsapp-access-token>",
"WHATSAPP_PHONE_NUMBER_ID": "<whatsapp-phone-number-id>",
"WHATSAPP_BUSINESS_ACCOUNT_ID": "<whatsapp-business-account-id>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"whatsapp-cloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-whatsapp-cloud"
],
"env": {
"WHATSAPP_ACCESS_TOKEN": "<whatsapp-access-token>",
"WHATSAPP_PHONE_NUMBER_ID": "<whatsapp-phone-number-id>",
"WHATSAPP_BUSINESS_ACCOUNT_ID": "<whatsapp-business-account-id>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"whatsapp-cloud": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-whatsapp-cloud"
],
"env": {
"WHATSAPP_ACCESS_TOKEN": "<whatsapp-access-token>",
"WHATSAPP_PHONE_NUMBER_ID": "<whatsapp-phone-number-id>",
"WHATSAPP_BUSINESS_ACCOUNT_ID": "<whatsapp-business-account-id>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| WHATSAPP_ACCESS_TOKEN | yes | yes | Meta system-user access token (permanent). Used as Bearer token for Graph API. |
| WHATSAPP_PHONE_NUMBER_ID | yes | — | WhatsApp Business phone number ID registered with Meta. |
| WHATSAPP_BUSINESS_ACCOUNT_ID | yes | — | WhatsApp Business Account (WABA) ID. Used for template management. |
| WHATSAPP_GRAPH_VERSION | — | — | Graph API version. Defaults to v21.0. Meta bumps quarterly. |
Freshness
Active — last maintenance signal 13d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-27 · 13d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-22 · 4mo ago · official registry · v0.2.2
FAQ
›How do I install the WhatsApp Cloud MCP server in Claude Code?
Run: claude mcp add whatsapp-cloud -e WHATSAPP_ACCESS_TOKEN='<whatsapp-access-token>' -e WHATSAPP_PHONE_NUMBER_ID='<whatsapp-phone-number-id>' -e WHATSAPP_BUSINESS_ACCOUNT_ID='<whatsapp-business-account-id>' -- npx -y @codespar/mcp-whatsapp-cloud. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does WhatsApp Cloud require an API key?
Yes. It expects WHATSAPP_ACCESS_TOKEN, WHATSAPP_PHONE_NUMBER_ID, WHATSAPP_BUSINESS_ACCOUNT_ID, of which 1 is a secret.
›Can I use WhatsApp Cloud as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is WhatsApp Cloud in the official MCP registry?
Yes, as io.github.codespar/mcp-whatsapp-cloud.
Alternatives to WhatsApp Cloud
Other communication MCP servers.
Skill SeekersActiveTurn docs, GitHub repos, PDFs, videos, Confluence, Notion and Slack/Discord into AI skills and RAG knowledge, exportable to vector databases like Qdrant.
Inbox ZeroActiveInbox Zero features on top of Gmail, such as finding emails that need a reply or follow-up.
WhatsAppAbandonedSearch personal WhatsApp messages and contacts, and send messages to individuals or groups.
VexaActiveMeeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
SlackSlowingThe most powerful MCP server for Slack Workspaces. This integration supports both Stdio and SSE transports, proxy settings and does not require any permissions or bots being created or approved by Workspace admins .
TelegramActiveTelegram API integration: access user data, manage dialogs (chats, channels, groups), retrieve and send messages, and handle read status.