WhatsApp Web MCP Server
local MCP serverInstallation
Terminal
claude mcp add mcp-whatsapp-web -e WHATSAPP_BACKEND=... -e BAILEYS_SESSION_DIR=... -e LOG_LEVEL=... -e LOG_STDERR_LEVEL=... -e WHATSAPP_HEADLESS=... -e WHATSAPP_NO_SANDBOX=... -e BROWSER_EXECUTABLE_PATH=... -e WHATSAPP_SESSION_DIR=... -e WHATSAPP_PAIRING_PHONE_NUMBER=... -e FFMPEG_PATH=... -e WA_WEB_VERSION=... -e HEALTH_CHECK_INTERVAL_MS=... -e TOOL_READY_TIMEOUT_MS=... -e MCP_HTTP_PORT=... -e MCP_HTTP_HOST=... -e MCP_OAUTH=... -- npx -y mcp-whatsapp-web
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"mcp-whatsapp-web": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"WHATSAPP_BACKEND": "...",
"BAILEYS_SESSION_DIR": "...",
"LOG_LEVEL": "...",
"LOG_STDERR_LEVEL": "...",
"WHATSAPP_HEADLESS": "...",
"WHATSAPP_NO_SANDBOX": "...",
"BROWSER_EXECUTABLE_PATH": "...",
"WHATSAPP_SESSION_DIR": "...",
"WHATSAPP_PAIRING_PHONE_NUMBER": "...",
"FFMPEG_PATH": "...",
"WA_WEB_VERSION": "...",
"HEALTH_CHECK_INTERVAL_MS": "...",
"TOOL_READY_TIMEOUT_MS": "...",
"MCP_HTTP_PORT": "...",
"MCP_HTTP_HOST": "...",
"MCP_OAUTH": "..."
}
}
}
}Fill in the environment variables with your own credentials.
Summary
WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts
Questions
WhatsApp Web MCP Server is a local MCP server distributed as the npm package mcp-whatsapp-web.
Run: claude mcp add mcp-whatsapp-web -e WHATSAPP_BACKEND=... -e BAILEYS_SESSION_DIR=... -e LOG_LEVEL=... -e LOG_STDERR_LEVEL=... -e WHATSAPP_HEADLESS=... -e WHATSAPP_NO_SANDBOX=... -e BROWSER_EXECUTABLE_PATH=... -e WHATSAPP_SESSION_DIR=... -e WHATSAPP_PAIRING_PHONE_NUMBER=... -e FFMPEG_PATH=... -e WA_WEB_VERSION=... -e HEALTH_CHECK_INTERVAL_MS=... -e TOOL_READY_TIMEOUT_MS=... -e MCP_HTTP_PORT=... -e MCP_HTTP_HOST=... -e MCP_OAUTH=... -- npx -y mcp-whatsapp-web
Run: codex mcp add mcp-whatsapp-web --env WHATSAPP_BACKEND=... --env BAILEYS_SESSION_DIR=... --env LOG_LEVEL=... --env LOG_STDERR_LEVEL=... --env WHATSAPP_HEADLESS=... --env WHATSAPP_NO_SANDBOX=... --env BROWSER_EXECUTABLE_PATH=... --env WHATSAPP_SESSION_DIR=... --env WHATSAPP_PAIRING_PHONE_NUMBER=... --env FFMPEG_PATH=... --env WA_WEB_VERSION=... --env HEALTH_CHECK_INTERVAL_MS=... --env TOOL_READY_TIMEOUT_MS=... --env MCP_HTTP_PORT=... --env MCP_HTTP_HOST=... --env MCP_OAUTH=... -- npx -y mcp-whatsapp-web
Similar MCP servers
NameStars
- Better Telegram MCPio.github.n24q02m/better-telegram-mcp11
- mcp-whatsapp-cloudio.github.codespar/mcp-whatsapp-cloud271
- mcp-z-apiio.github.codespar/mcp-z-api271
- mcp-evolution-apiio.github.codespar/mcp-evolution-api271
- slackcom.pulsemcp/slack80
- iCloud MCPio.github.MrGo2/icloud-mcp54
- Apple Messagesio.github.JonathanRReed/apple-messages-mcp18
- Microsoft 365 Teamsio.github.mindstone/mcp-server-microsoft-teams12