AI Plugin Index
WhatsApp Web MCP Server
CommunityMCP server by mario-andreschak · updated · ★ 29
WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts WhatsApp Web MCP Server is a community project by mario-andreschak, not verified by a company domain.
Install WhatsApp Web MCP Server
Built from the published package, never by AIclaude mcp add whatsapp-web-mcp-server -- npx -y mcp-whatsapp-webRun in your terminal. Add --scope user to use it in every project.
Step-by-step: install WhatsApp Web MCP Server in Claude Code
{
"mcpServers": {
"whatsapp-web-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
Step-by-step: install WhatsApp Web MCP Server in Claude Desktop
{
"mcpServers": {
"whatsapp-web-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"whatsapp-web-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add whatsapp-web-mcp-server -- npx -y mcp-whatsapp-web{
"mcpServers": {
"whatsapp-web-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-whatsapp-web"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
Step-by-step: install WhatsApp Web MCP Server in Antigravity CLI
gemini mcp add whatsapp-web-mcp-server npx -y mcp-whatsapp-webGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the whatsapp-web-mcp-server block.
Last commit 36 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
WHATSAPP_Environment variable | Optional | WhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing Default: webjs |
BAILEYS_Environment variable | Optional | Baileys credentials and synchronized history directory (default: <working directory>/baileys-sessions). Use a private absolute path, owned by one server process. |
LOG_Environment variable | Optional | Log level for the log file (logs/mcp-whatsapp.log) Default: info |
LOG_Environment variable | Optional | Log level for stderr (visible in most MCP client logs) Default: warn |
WHATSAPP_Environment variable | Optional | webjs only: set to false to show the browser window instead of running headless |
WHATSAPP_Environment variable | Optional | webjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default. Default: false |
BROWSER_Environment variable | Optional | webjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs. |
WHATSAPP_Environment variable | Optional | webjs only: persistent browser profile directory (default: <working directory>/whatsapp-sessions) |
WHATSAPP_Environment variable | Optional | Phone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code |
FFMPEG_Environment variable | Optional | Path to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package) |
WA_Environment variable | Optional | webjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client. |
HEALTH_Environment variable | Optional | webjs only: connection health check interval in milliseconds (<=0 disables) Default: 60000 |
TOOL_Environment variable | Optional | How long tool calls wait for the WhatsApp client to become ready before erroring Default: 45000 |
MCP_Environment variable | Optional | When set, additionally exposes the MCP endpoint at http://127.0.0.1:<port>/mcp (Streamable HTTP) from the same process |
MCP_Environment variable | Optional | Bind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account) Default: 127.0.0.1 |
MCP_Environment variable | Optional | Enable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like WhatsApp Web MCP Server? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to WhatsApp Web MCP Server
All alternatives →
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.
Cited company knowledge from Slack, meetings, transcripts, and decisions
Minimal chat-first app with durable threads, actions, and the app-agent loop
Central Slack/Telegram router with jobs, memory, approvals, and A2A delegation
Agent-Native Superhuman - email client with keyboard shortcuts and AI triage
WhatsApp Web MCP Server: common questions
How do I install WhatsApp Web MCP Server?
In Claude Code run claude mcp add whatsapp-web-mcp-server -- npx -y mcp-whatsapp-web. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is WhatsApp Web MCP Server the official server?
WhatsApp Web MCP Server is a community project by mario-andreschak, not verified by a company domain.
Is WhatsApp Web MCP Server free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is WhatsApp Web MCP Server safe to use?
It scores 65 of 100. Grades: maintenance B, licence A, quality D. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to WhatsApp Web MCP Server?
Similar MCP servers: Vexa, TradingMCP, Agent-Native Brain, Agent-Native Chat.
Does WhatsApp Web MCP Server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.