WhatsApp Web MCP Server
io.github.mario-andreschak/mcp-whatsapp-web · version 1.2.0
Community listing. Not installed or verified by cosmic-mcp. Read the source and its permissions before you run it.
WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts
https://github.com/mario-andreschak/mcp-whatsapp-webQuick facts
- Listing: Community
- Published Sep 5, 19:08 UTC
- Transport: stdio
- Package: npm
mcp-whatsapp-web1.2.0 - Listed by cosmic-mcp: Nov 9, 04:26 UTC
Details
- Repository: https://github.com/mario-andreschak/mcp-whatsapp-web
- npm: https://www.npmjs.com/package/mcp-whatsapp-web
- Website: https://github.com/mario-andreschak/mcp-whatsapp-web
- Needs settings:
WHATSAPP_BACKENDBAILEYS_SESSION_DIRLOG_LEVELLOG_STDERR_LEVELWHATSAPP_HEADLESSWHATSAPP_NO_SANDBOXBROWSER_EXECUTABLE_PATHWHATSAPP_SESSION_DIRWHATSAPP_PAIRING_PHONE_NUMBERFFMPEG_PATHWA_WEB_VERSIONHEALTH_CHECK_INTERVAL_MSTOOL_READY_TIMEOUT_MSMCP_HTTP_PORTMCP_HTTP_HOSTMCP_OAUTH
Setup snippets
Generated from the registry entry. cosmic-mcp has not run or reviewed this server; values in angle brackets are yours to fill in.
Run it locally (npm)
npx -y '[email protected]'Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"mcp-whatsapp-web": {
"args": [
"-y",
"[email protected]"
],
"command": "npx",
"env": {
"BAILEYS_SESSION_DIR": "<your baileys session dir>",
"BROWSER_EXECUTABLE_PATH": "<your browser executable path>",
"FFMPEG_PATH": "<your ffmpeg path>",
"HEALTH_CHECK_INTERVAL_MS": "<your health check interval ms>",
"LOG_LEVEL": "<your log level>",
"LOG_STDERR_LEVEL": "<your log stderr level>",
"MCP_HTTP_HOST": "<your mcp http host>",
"MCP_HTTP_PORT": "<your mcp http port>",
"MCP_OAUTH": "<your mcp oauth>",
"TOOL_READY_TIMEOUT_MS": "<your tool ready timeout ms>",
"WA_WEB_VERSION": "<your wa web version>",
"WHATSAPP_BACKEND": "<your whatsapp backend>",
"WHATSAPP_HEADLESS": "<your whatsapp headless>",
"WHATSAPP_NO_SANDBOX": "<your whatsapp no sandbox>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your whatsapp pairing phone number>",
"WHATSAPP_SESSION_DIR": "<your whatsapp session dir>"
}
}
}
}Claude Code
claude mcp add 'mcp-whatsapp-web' -- npx -y '[email protected]'Cursor (.cursor/mcp.json)
{
"mcpServers": {
"mcp-whatsapp-web": {
"args": [
"-y",
"[email protected]"
],
"command": "npx",
"env": {
"BAILEYS_SESSION_DIR": "<your baileys session dir>",
"BROWSER_EXECUTABLE_PATH": "<your browser executable path>",
"FFMPEG_PATH": "<your ffmpeg path>",
"HEALTH_CHECK_INTERVAL_MS": "<your health check interval ms>",
"LOG_LEVEL": "<your log level>",
"LOG_STDERR_LEVEL": "<your log stderr level>",
"MCP_HTTP_HOST": "<your mcp http host>",
"MCP_HTTP_PORT": "<your mcp http port>",
"MCP_OAUTH": "<your mcp oauth>",
"TOOL_READY_TIMEOUT_MS": "<your tool ready timeout ms>",
"WA_WEB_VERSION": "<your wa web version>",
"WHATSAPP_BACKEND": "<your whatsapp backend>",
"WHATSAPP_HEADLESS": "<your whatsapp headless>",
"WHATSAPP_NO_SANDBOX": "<your whatsapp no sandbox>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your whatsapp pairing phone number>",
"WHATSAPP_SESSION_DIR": "<your whatsapp session dir>"
}
}
}
}VS Code (.vscode/mcp.json)
{
"servers": {
"mcp-whatsapp-web": {
"args": [
"-y",
"[email protected]"
],
"command": "npx",
"env": {
"BAILEYS_SESSION_DIR": "<your baileys session dir>",
"BROWSER_EXECUTABLE_PATH": "<your browser executable path>",
"FFMPEG_PATH": "<your ffmpeg path>",
"HEALTH_CHECK_INTERVAL_MS": "<your health check interval ms>",
"LOG_LEVEL": "<your log level>",
"LOG_STDERR_LEVEL": "<your log stderr level>",
"MCP_HTTP_HOST": "<your mcp http host>",
"MCP_HTTP_PORT": "<your mcp http port>",
"MCP_OAUTH": "<your mcp oauth>",
"TOOL_READY_TIMEOUT_MS": "<your tool ready timeout ms>",
"WA_WEB_VERSION": "<your wa web version>",
"WHATSAPP_BACKEND": "<your whatsapp backend>",
"WHATSAPP_HEADLESS": "<your whatsapp headless>",
"WHATSAPP_NO_SANDBOX": "<your whatsapp no sandbox>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your whatsapp pairing phone number>",
"WHATSAPP_SESSION_DIR": "<your whatsapp session dir>"
},
"type": "stdio"
}
}
}Related servers
- AnomalyArmor Verified domain
Data observability tools for engineering teams: alerts, freshness, schema drift, lineage, quality. - backengine-mcp Verified domain
Surface customer & prospect context from Slack, email, transcripts and tickets in any MCP client. - AiVikings.ai Verified domain
Find, register, and manage domains from any AI chat or agent - Artil — Email, SMS & Messaging for AI Agents Verified domain
Give AI agents own email inbox, SMS numbers, and workspace accounts to receive and send messages. - Atako Verified domain
Remote MCP server to run your Atako AI agents: chat, projects, files, integrations and channels. - AwrAIter — Telegram channels Verified domain
Telegram channels you administer: analytics, content plans, scheduled publishing. No userbot