WhatsApp

Provides tools to connect to WhatsApp Web, list chats, send messages, and read recent messages via an MCP server.

typescript

0

GitHub Stars

typescript

Language

1 month ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "deamondev888-whatsapp-mcpserver": {
      "command": "node",
      "args": [
        "/chemin/vers/whatsapp-server/dist/index.js"
      ]
    }
  }
}

You can run a dedicated MCP (Model Context Protocol) server to control WhatsApp Web through Puppeteer Stealth, enabling your AI to read and send messages as a human user. This MCP server exposes tools to connect to WhatsApp Web, list conversations, read messages, and send messages, so your client can orchestrate conversational flows with real-time chat interactions.

How to use

You will interact with the WhatsApp MCP server using an MCP client. Start by connecting to WhatsApp, then list chats, read recent messages, and send messages as your automation demands. The server handles browser automation, preserves sessions, and exposes the available tools to your MCP client.

How to install

Prerequisites: You need Node.js and a package manager that can run pnpm commands. The server is written in TypeScript and is built to run as an MCP (stdio) backend.

Clone or copy the whatsapp-server folder to your environment.
Install dependencies using pnpm.

pnpm install

Compile the TypeScript source to JavaScript.

pnpm run build

Register the MCP server in your central MCP configuration. Use the exact command and path shown for starting the server.

"whatsapp-server": {
  "command": "node",
  "args": [
    "/chemin/vers/whatsapp-server/dist/index.js"
  ],
  "disabled": false
}

Additional sections

Configuration and security notes help you run the server safely and reliably.

Anti-ban and human-like behavior are achieved through Puppeteer Stealth, randomized delays between actions, and session persistence. The server maintains a persistent WhatsApp session in a dedicated folder to avoid repeated re-scans. It uses a realistic user agent and can auto-dismiss dialogs when needed. When you restart, the server closes the old browser before starting a new session.

Available tools include connecting to WhatsApp, listing chats, sending messages, and reading messages. You use these through the MCP client to enact your automation flows.

Available tools

connect_whatsapp

Lanse the browser and opens WhatsApp Web to establish a session for subsequent tool usage.

list_chats

Retrieve a list of recent conversations up to a specified limit.

send_message

Send a message to a specific contact or group by providing the chat name and message content.

read_messages

Read recent messages from a specific chat, with a limit on how many messages to retrieve.