Whats App Mcp Server

Name: Whats App Mcp Server
Author: meharajM

@meharajM

关于 Whats App Mcp Server

Human-in-the-loop approvals & notifications for AI agents via WhatsApp (MCP server)

#mcp #model-context-protocol #cursor #claude #claude-desktop #ai-agent #agentic-ai #whatsapp #automation #notifications #approval-workflow #typescript #human-in-the-loop

基本信息

分类

沟通协作

传输方式

stdio

发布者

meharajM

提交者

Meharaj M

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "[email protected]"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Whats App Mcp Server?

Whats App Mcp Server is an MCP (Model Context Protocol) server that enables AI agents (like Claude or Cursor) to interact directly with users via WhatsApp. It bridges the gap between autonomous AI and the user’s phone, allowing runtime confirmations, permission requests, and status updates while away from the computer.

How to use Whats App Mcp Server?

Configure your MCP client (Cursor, Claude Desktop, etc.) to run the server via npx -y @mhrj/whatsapp-mcp and set the environment variable WHATSAPP_TARGET_NUMBER. Optionally restrict reply sources with WHATSAPP_ALLOWED_NUMBERS. First-time authentication: call the connect tool, scan the QR code with WhatsApp. Then use tools like ask_question to receive replies or send_message for one-way notifications.

Key features of Whats App Mcp Server

Connect/disconnect to WhatsApp network
Send one-way notifications via send_message
Ask questions and block until a reply is received
Concurrent questions are smartly queued and tagged
Get connection status with get_status

Use cases of Whats App Mcp Server

AI agents requesting approval before deploying to production
Remote monitoring and alerts when you are away from the IDE
Collaborative debugging with agent asking for your input
Fully autonomous workflows with human‑in‑the‑loop permissions
DevOps teams integrating approval steps into agentic pipelines

FAQ from Whats App Mcp Server

How do I authenticate for the first time?

Call the connect tool. The agent returns a QR code image; scan it with WhatsApp (Linked Devices > Link a Device). The session is saved to ~/.whatsapp-mcp/baileys_auth_info.

What environment variables are required?

WHATSAPP_TARGET_NUMBER (default recipient, e.g., [email protected]). Optionally add WHATSAPP_ALLOWED_NUMBERS (comma‑separated) to restrict who can reply.

Can it be used with Cursor or Claude Desktop?

Yes. Add the server configuration to your MCP config file with npx and the required environment variables.

How do I set up autonomous “auto‑pilot” mode?

Remove IDE security blockers (always allow command/file permissions) and add a .cursorrules prompt that instructs the AI to use the ask_question tool via WhatsApp for decision points.