WhatsApp Web MCP Server
Rank #14,131io.github.mario-andreschak/mcp-whatsapp-web
MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts
WhatsApp Web MCP Server is a Model Context Protocol (MCP) server published by mario-andreschak. It ranks #14,131 of 115,460 servers tracked on MCP Toplist, and its repository has 22 GitHub stars. WhatsApp Web MCP Server is listed across 3 registries — Official MCP, Glama and PulseMCP, with 1 tracked version. It was first listed on Apr 14, 2025 and most recently updated on Jul 5, 2026.
Ranks ahead of 101,329 of 115,460 servers on MCP Toplist.
Use WhatsApp Web MCP Server
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add mcp-whatsapp-web -e "LOG_LEVEL=<your LOG_LEVEL>" -e "LOG_STDERR_LEVEL=<your LOG_STDERR_LEVEL>" -e "WHATSAPP_HEADLESS=<your WHATSAPP_HEADLESS>" -e "BROWSER_EXECUTABLE_PATH=<your BROWSER_EXECUTABLE_PATH>" -e "WHATSAPP_SESSION_DIR=<your WHATSAPP_SESSION_DIR>" -e "WHATSAPP_PAIRING_PHONE_NUMBER=<your WHATSAPP_PAIRING_PHONE_NUMBER>" -e "FFMPEG_PATH=<your FFMPEG_PATH>" -e "WA_WEB_VERSION=<your WA_WEB_VERSION>" -e "HEALTH_CHECK_INTERVAL_MS=<your HEALTH_CHECK_INTERVAL_MS>" -e "TOOL_READY_TIMEOUT_MS=<your TOOL_READY_TIMEOUT_MS>" -e "MCP_HTTP_PORT=<your MCP_HTTP_PORT>" -e "MCP_HTTP_HOST=<your MCP_HTTP_HOST>" -e "MCP_OAUTH=<your MCP_OAUTH>" -- npx -y mcp-whatsapp-webReplace each placeholder with your own value before saving.
[mcp_servers.mcp-whatsapp-web]
command = "npx"
args = ["-y", "mcp-whatsapp-web"]
[mcp_servers.mcp-whatsapp-web.env]
LOG_LEVEL = "<your LOG_LEVEL>"
LOG_STDERR_LEVEL = "<your LOG_STDERR_LEVEL>"
WHATSAPP_HEADLESS = "<your WHATSAPP_HEADLESS>"
BROWSER_EXECUTABLE_PATH = "<your BROWSER_EXECUTABLE_PATH>"
WHATSAPP_SESSION_DIR = "<your WHATSAPP_SESSION_DIR>"
WHATSAPP_PAIRING_PHONE_NUMBER = "<your WHATSAPP_PAIRING_PHONE_NUMBER>"
FFMPEG_PATH = "<your FFMPEG_PATH>"
WA_WEB_VERSION = "<your WA_WEB_VERSION>"
HEALTH_CHECK_INTERVAL_MS = "<your HEALTH_CHECK_INTERVAL_MS>"
TOOL_READY_TIMEOUT_MS = "<your TOOL_READY_TIMEOUT_MS>"
MCP_HTTP_PORT = "<your MCP_HTTP_PORT>"
MCP_HTTP_HOST = "<your MCP_HTTP_HOST>"
MCP_OAUTH = "<your MCP_OAUTH>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-whatsapp-web": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"LOG_LEVEL": "<your LOG_LEVEL>",
"LOG_STDERR_LEVEL": "<your LOG_STDERR_LEVEL>",
"WHATSAPP_HEADLESS": "<your WHATSAPP_HEADLESS>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"WHATSAPP_SESSION_DIR": "<your WHATSAPP_SESSION_DIR>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your WHATSAPP_PAIRING_PHONE_NUMBER>",
"FFMPEG_PATH": "<your FFMPEG_PATH>",
"WA_WEB_VERSION": "<your WA_WEB_VERSION>",
"HEALTH_CHECK_INTERVAL_MS": "<your HEALTH_CHECK_INTERVAL_MS>",
"TOOL_READY_TIMEOUT_MS": "<your TOOL_READY_TIMEOUT_MS>",
"MCP_HTTP_PORT": "<your MCP_HTTP_PORT>",
"MCP_HTTP_HOST": "<your MCP_HTTP_HOST>",
"MCP_OAUTH": "<your MCP_OAUTH>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-whatsapp-web": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"LOG_LEVEL": "<your LOG_LEVEL>",
"LOG_STDERR_LEVEL": "<your LOG_STDERR_LEVEL>",
"WHATSAPP_HEADLESS": "<your WHATSAPP_HEADLESS>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"WHATSAPP_SESSION_DIR": "<your WHATSAPP_SESSION_DIR>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your WHATSAPP_PAIRING_PHONE_NUMBER>",
"FFMPEG_PATH": "<your FFMPEG_PATH>",
"WA_WEB_VERSION": "<your WA_WEB_VERSION>",
"HEALTH_CHECK_INTERVAL_MS": "<your HEALTH_CHECK_INTERVAL_MS>",
"TOOL_READY_TIMEOUT_MS": "<your TOOL_READY_TIMEOUT_MS>",
"MCP_HTTP_PORT": "<your MCP_HTTP_PORT>",
"MCP_HTTP_HOST": "<your MCP_HTTP_HOST>",
"MCP_OAUTH": "<your MCP_OAUTH>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"mcp-whatsapp-web": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"LOG_LEVEL": "<your LOG_LEVEL>",
"LOG_STDERR_LEVEL": "<your LOG_STDERR_LEVEL>",
"WHATSAPP_HEADLESS": "<your WHATSAPP_HEADLESS>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"WHATSAPP_SESSION_DIR": "<your WHATSAPP_SESSION_DIR>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your WHATSAPP_PAIRING_PHONE_NUMBER>",
"FFMPEG_PATH": "<your FFMPEG_PATH>",
"WA_WEB_VERSION": "<your WA_WEB_VERSION>",
"HEALTH_CHECK_INTERVAL_MS": "<your HEALTH_CHECK_INTERVAL_MS>",
"TOOL_READY_TIMEOUT_MS": "<your TOOL_READY_TIMEOUT_MS>",
"MCP_HTTP_PORT": "<your MCP_HTTP_PORT>",
"MCP_HTTP_HOST": "<your MCP_HTTP_HOST>",
"MCP_OAUTH": "<your MCP_OAUTH>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-whatsapp-web": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"LOG_LEVEL": "<your LOG_LEVEL>",
"LOG_STDERR_LEVEL": "<your LOG_STDERR_LEVEL>",
"WHATSAPP_HEADLESS": "<your WHATSAPP_HEADLESS>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"WHATSAPP_SESSION_DIR": "<your WHATSAPP_SESSION_DIR>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your WHATSAPP_PAIRING_PHONE_NUMBER>",
"FFMPEG_PATH": "<your FFMPEG_PATH>",
"WA_WEB_VERSION": "<your WA_WEB_VERSION>",
"HEALTH_CHECK_INTERVAL_MS": "<your HEALTH_CHECK_INTERVAL_MS>",
"TOOL_READY_TIMEOUT_MS": "<your TOOL_READY_TIMEOUT_MS>",
"MCP_HTTP_PORT": "<your MCP_HTTP_PORT>",
"MCP_HTTP_HOST": "<your MCP_HTTP_HOST>",
"MCP_OAUTH": "<your MCP_OAUTH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"mcp-whatsapp-web": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"LOG_LEVEL": "<your LOG_LEVEL>",
"LOG_STDERR_LEVEL": "<your LOG_STDERR_LEVEL>",
"WHATSAPP_HEADLESS": "<your WHATSAPP_HEADLESS>",
"BROWSER_EXECUTABLE_PATH": "<your BROWSER_EXECUTABLE_PATH>",
"WHATSAPP_SESSION_DIR": "<your WHATSAPP_SESSION_DIR>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<your WHATSAPP_PAIRING_PHONE_NUMBER>",
"FFMPEG_PATH": "<your FFMPEG_PATH>",
"WA_WEB_VERSION": "<your WA_WEB_VERSION>",
"HEALTH_CHECK_INTERVAL_MS": "<your HEALTH_CHECK_INTERVAL_MS>",
"TOOL_READY_TIMEOUT_MS": "<your TOOL_READY_TIMEOUT_MS>",
"MCP_HTTP_PORT": "<your MCP_HTTP_PORT>",
"MCP_HTTP_HOST": "<your MCP_HTTP_HOST>",
"MCP_OAUTH": "<your MCP_OAUTH>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.mario-andreschak%2Fmcp-whatsapp-web)<a href="https://mcptoplist.com/server/io.github.mario-andreschak%2Fmcp-whatsapp-web"><img src="https://mcptoplist.com/badge/io.github.mario-andreschak%2Fmcp-whatsapp-web.svg" alt="MCP Toplist: Top 25% of 115,460" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 3 registries
mario-andreschak
Other servers by mario-andreschak
- MCP ABAP ADT#4,858 · 1 ver
- MCP Video Recognition Server#5,233
- ABAP-ADT-API MCP-Server#6,340 · 1 ver
- MCP SAP GUI Server#9,614
- MCP Windows Desktop Automation#10,051
- MCP Image Recognition Server#14,857
- MCP GameBoy Server#16,237
- MCP Video Generation with Veo2#16,238
- MCP Office Interop Word Server#20,822
- mcp-voice#64,606
Available versions (1)
| Version | Published |
|---|---|
| 1.1.0 | Jul 5, 2026 |
Frequently asked questions
- Who maintains WhatsApp Web MCP Server?
- WhatsApp Web MCP Server is maintained by mario-andreschak, which publishes 11 MCP servers (3 total versions) tracked on MCP Toplist.
- Is WhatsApp Web MCP Server listed on the Official MCP Registry?
- Yes — WhatsApp Web MCP Server is listed on the Official MCP Registry, alongside Glama and PulseMCP.
- How many versions does WhatsApp Web MCP Server have?
- MCP Toplist tracks 1 version of WhatsApp Web MCP Server, most recently published on Jul 5, 2026.
- Where can I find the source code for WhatsApp Web MCP Server?
- The source code for WhatsApp Web MCP Server is hosted at github.com/mario-andreschak/mcp-whatsapp-web.