WhatsApp Web MCP Server for Cursor
io.github.mario-andreschak/mcp-whatsapp-web
WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts
client:Cursor
transport:stdio
runtime:npm
Install WhatsApp Web MCP Server in Cursor
~/.cursor/mcp.json · windows: %USERPROFILE%\.cursor\mcp.json
{
"mcpServers": {
"mcp-whatsapp-web": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"WHATSAPP_BACKEND": "<WHATSAPP_BACKEND>",
"BAILEYS_SESSION_DIR": "<BAILEYS_SESSION_DIR>",
"LOG_LEVEL": "<LOG_LEVEL>",
"LOG_STDERR_LEVEL": "<LOG_STDERR_LEVEL>",
"WHATSAPP_HEADLESS": "<WHATSAPP_HEADLESS>",
"WHATSAPP_NO_SANDBOX": "<WHATSAPP_NO_SANDBOX>",
"BROWSER_EXECUTABLE_PATH": "<BROWSER_EXECUTABLE_PATH>",
"WHATSAPP_SESSION_DIR": "<WHATSAPP_SESSION_DIR>",
"WHATSAPP_PAIRING_PHONE_NUMBER": "<WHATSAPP_PAIRING_PHONE_NUMBER>",
"FFMPEG_PATH": "<FFMPEG_PATH>",
"WA_WEB_VERSION": "<WA_WEB_VERSION>",
"HEALTH_CHECK_INTERVAL_MS": "<HEALTH_CHECK_INTERVAL_MS>",
"TOOL_READY_TIMEOUT_MS": "<TOOL_READY_TIMEOUT_MS>",
"MCP_HTTP_PORT": "<MCP_HTTP_PORT>",
"MCP_HTTP_HOST": "<MCP_HTTP_HOST>",
"MCP_OAUTH": "<MCP_OAUTH>"
}
}
}
}
Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs