WhatsApp Web MCP Server

io.github.mario-andreschak/mcp-whatsapp-web

WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts

View repository →Homepage →

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "mcp-whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web@1.2.0"
      ],
      "env": {
        "WHATSAPP_BACKEND": "webjs",
        "LOG_LEVEL": "info",
        "LOG_STDERR_LEVEL": "warn",
        "WHATSAPP_NO_SANDBOX": "false",
        "HEALTH_CHECK_INTERVAL_MS": "60000",
        "TOOL_READY_TIMEOUT_MS": "45000",
        "MCP_HTTP_HOST": "127.0.0.1"
      }
    }
  }
}
Environment variables
  • WHATSAPP_BACKENDWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
  • LOG_LEVELLog level for the log file (logs/mcp-whatsapp.log)
  • LOG_STDERR_LEVELLog level for stderr (visible in most MCP client logs)
  • WHATSAPP_NO_SANDBOXwebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
  • HEALTH_CHECK_INTERVAL_MSwebjs only: connection health check interval in milliseconds (<=0 disables)
  • TOOL_READY_TIMEOUT_MSHow long tool calls wait for the WhatsApp client to become ready before erroring
  • MCP_HTTP_HOSTBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Communication
Version
1.2.0
Registry
active
Published
9/5/2026

More Communication servers

Browse all Communication →

io.github.mrfentmen/twilio-mcp-server

mrfentmen

Send SMS, MMS, WhatsApp messages, make voice calls, and manage Twilio phone numbers.

CommunicationAdded 3 weeks ago

Telegram MCP

n24q02m

Telegram for AI agents: messages, chats, media, and contacts in bot and user-account modes.

CommunicationAdded 2 weeks ago

io.github.razvangirgiz/wazap

razvangirgiz

WhatsApp for your agent: chats, messages, media, contacts and groups behind MCP tools.

CommunicationAdded 2 weeks ago

io.github.rixile9999/tdl-mcp

rixile9999

Read-only Telegram MCP server wrapping the tdl CLI: list chats, read messages, download media.

CommunicationAdded 3 weeks ago

io.github.saloprj/dialogbrain

saloprj

Unified inbox MCP for WhatsApp, Telegram, Email, voice — read/send messages, search, AI agents.

CommunicationAdded 5 months ago

io.github.udah1/cursor-chat-bridge

udah1

Drive the Cursor agent from Telegram, Discord, or GitHub — with images and voice notes.

CommunicationAdded 3 months ago

Add the badge to your site

Show visitors that WhatsApp Web MCP Server is listed here — it’s also the link we check for a free listing.

WhatsApp Web MCP Server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-mario-andreschak-mcp-whatsapp-web?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="WhatsApp Web MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![WhatsApp Web MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-mario-andreschak-mcp-whatsapp-web?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.