WhatsApp Web MCP Server
MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts
Install and compare this MCP server
Use this profile to copy client config, check auth requirements, review tools and resources, and compare related MCP servers before adding it to an AI client.
- Install
- npx -y mcp-whatsapp-web
- Clients
- Claude, Cursor, VS Code, Codex
- Transport
- STDIO
- Auth
- Not captured
- Capabilities
- 0 tools, 0 resources, 0 prompts
- Related
- mcp-abap-abap-adt-api, mcp-abap-adt, Website Auditor
Want MCP integration examples?
Get practical integration notes and launch examples for MCP servers like WhatsApp Web MCP Server.
Install
Connection
- Transport
- STDIO
- Command
npx -y mcp-whatsapp-web- Environment
{ "LOG_LEVEL": "info", "LOG_STDERR_LEVEL": "warn", "WHATSAPP_HEADLESS": "YOUR_VALUE_HERE", "BROWSER_EXECUTABLE_PATH": "YOUR_VALUE_HERE", "WHATSAPP_SESSION_DIR": "YOUR_VALUE_HERE", "WHATSAPP_PAIRING_PHONE_NUMBER": "YOUR_VALUE_HERE", "FFMPEG_PATH": "YOUR_VALUE_HERE", "WA_WEB_VERSION": "YOUR_VALUE_HERE", "HEALTH_CHECK_INTERVAL_MS": "60000", "TOOL_READY_TIMEOUT_MS": "45000", "MCP_HTTP_PORT": "YOUR_VALUE_HERE", "MCP_HTTP_HOST": "127.0.0.1", "MCP_OAUTH": "YOUR_VALUE_HERE" }
Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-mario-andreschak-mcp-whatsapp-web": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
],
"env": {
"LOG_LEVEL": "info",
"LOG_STDERR_LEVEL": "warn",
"WHATSAPP_HEADLESS": "YOUR_VALUE_HERE",
"BROWSER_EXECUTABLE_PATH": "YOUR_VALUE_HERE",
"WHATSAPP_SESSION_DIR": "YOUR_VALUE_HERE",
"WHATSAPP_PAIRING_PHONE_NUMBER": "YOUR_VALUE_HERE",
"FFMPEG_PATH": "YOUR_VALUE_HERE",
"WA_WEB_VERSION": "YOUR_VALUE_HERE",
"HEALTH_CHECK_INTERVAL_MS": "60000",
"TOOL_READY_TIMEOUT_MS": "45000",
"MCP_HTTP_PORT": "YOUR_VALUE_HERE",
"MCP_HTTP_HOST": "127.0.0.1",
"MCP_OAUTH": "YOUR_VALUE_HERE"
}
}
}
}Config location
- macOS
~/Library/Application Support/Claude/claude_desktop_config.json- Windows
%APPDATA%\Claude\claude_desktop_config.json
Auth
Package transportNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
Tools & Resources
No public tools, resources, or prompts captured yet. Use Auth when this server requires credentials.
Tools
No tools captured yet.
Resources
No resources captured yet.
Prompts
No prompts captured yet.
Questions
What is WhatsApp Web MCP Server?+
WhatsApp Web MCP Server is an MCP server for MCP server for WhatsApp via whatsapp-web.js: send/receive messages, media, chats, groups, contacts. It supports STDIO transport.
How do I install WhatsApp Web MCP Server?+
Use the generated config in Install. This server runs with npx -y mcp-whatsapp-web; add any required environment variables before starting your client.
How do I add WhatsApp Web MCP Server to Claude Desktop?+
Choose the Claude Desktop tab in Install and copy the config for npx -y mcp-whatsapp-web. Add required environment variables before starting Claude Desktop.
How do I add WhatsApp Web MCP Server to Claude Code?+
Choose the Claude Code tab in Install and copy the config for npx -y mcp-whatsapp-web. Add required environment variables before starting Claude Code.
How do I use WhatsApp Web MCP Server with Codex?+
Choose the Codex tab in Install and copy the config for npx -y mcp-whatsapp-web. Add required environment variables before starting Codex.
How do I add WhatsApp Web MCP Server to Cursor or VS Code?+
Choose the Cursor or VS Code tab in Install and copy the config for npx -y mcp-whatsapp-web. Add required environment variables before starting Cursor or VS Code.
What endpoint and transport does WhatsApp Web MCP Server use?+
WhatsApp Web MCP Server uses STDIO transport. Use the package or command config in Install.
What tools and resources does WhatsApp Web MCP Server expose?+
WhatsApp Web MCP Server inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
Does WhatsApp Web MCP Server require authentication?+
WhatsApp Web MCP Server does not advertise a verified auth requirement. If discovery fails, it may still need provider login, an API key, a bearer token, or a session header.
Related MCPs
mcp-abap-abap-adt-apiMCP server wrapping abap-adt-api for ABAP ADT development workflows against SAP systemsmcp-abap-adtABAP ADT MCP server for reading SAP objects (programs, classes, tables, CDS) via ADTWebsite AuditorAI visibility + site audits: see if ChatGPT, Perplexity, Claude & Gemini recommend a website.blockrun-mcpWeb search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.BowmarkDo things on live websites: prices, availability, quotes, bookings, anything behind a form or login.mcpProfile, CV, jobs, compensation & application-tracking tools for AI agents, by aicandidatehub.com.
Profile notes
- Package: Npm mcp-whatsapp-web v1.1.0
- Environment variable: LOG_LEVEL (default info; choices trace, debug, info, warn, error, fatal)
- Environment variable: LOG_STDERR_LEVEL (default warn; choices trace, debug, info, warn, error, fatal)
- Environment variable: WHATSAPP_HEADLESS
- Environment variable: BROWSER_EXECUTABLE_PATH
- Environment variable: WHATSAPP_SESSION_DIR
- Environment variable: WHATSAPP_PAIRING_PHONE_NUMBER
- Environment variable: FFMPEG_PATH
- Environment variable: WA_WEB_VERSION
- Environment variable: HEALTH_CHECK_INTERVAL_MS (default 60000)
- Environment variable: TOOL_READY_TIMEOUT_MS (default 45000)
- Environment variable: MCP_HTTP_PORT
- Environment variable: MCP_HTTP_HOST (default 127.0.0.1)
- Environment variable: MCP_OAUTH
Packages
| Package | Registry | Version | Inputs |
|---|---|---|---|
mcp-whatsapp-webstdio | npm | 1.1.0 | Env: LOG_LEVEL Env: LOG_STDERR_LEVEL Env: WHATSAPP_HEADLESS 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 |
Details
- Version
- 1.1.0
- Updated
- Jul 5, 2026