MCP Whatsapp Web MCP Server

TypeScript MCP server for WhatsApp using whatsapp-web.js

Local serverstdioTypeScript

What is the MCP Whatsapp Web MCP Server?

TypeScript MCP server for WhatsApp using whatsapp-web.js

What you get

Automation of Whatsapp Messages without Meta (Business-)API is against WhatsApp' Terms of Service! You take full responsibility for everything you do with this MCP-Server. It is possible that your account will be flagged/restricted.

  • TypeScript Implementation — Fully typed codebase for better developer experience and code reliability
  • WhatsApp Web Integration — Uses whatsapp-web.js for direct connection to WhatsApp Web
  • MCP Server — Implements the Model Context Protocol for seamless integration with AI assistants
  • Media Support — Send and receive images, videos, documents, and audio messages
  • Multiple Transport Options — Supports stdio and Streamable HTTP transports — even both at once from a single process (start with stdio and set MCP_HTTP_PORT to additionally expose http://127.0.0.1:/mcp, or run HTTP-only with --http)

Configuration and credentials

  • Node.js >= 20.0.0 - npm or yarn - Google Chrome or Microsoft Edge (auto-detected; only needed for sending videos/GIFs — everything else works with the Chromium that puppeteer downloads automatically) FFmpeg is bundled automatically via the ffmpeg-static npm package — no manual installation needed. You can point the FFMPEG_PATH environment variable at your own binary to override it.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the MCP Whatsapp Web MCP Server

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": [
        "mcp-whatsapp-web"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js >= 20.0.0 - npm or yarn - Google Chrome or Microsoft Edge (auto-detected; only needed for sending videos/GIFs — everything else works with the Chromium that puppeteer downloads automatically) FFmpeg is bundled automatically via the ffmpeg-static npm package — no manual installation needed. You can point the FFMPEG_PATH environment variable at your own binary to override it.

Example prompts to try

  • “Use MCP Whatsapp Web to Authentication.”
  • “Use MCP Whatsapp Web to Contacts.”
  • “Use MCP Whatsapp Web to Chats.”

Frequently asked questions

TypeScript MCP server for WhatsApp using whatsapp-web.js Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.