WhatsApp MCP Server

by meharajmio.github.meharajM/whatsapp-mcpv2.0.1

WhatsApp MCP Server: Human-in-the-loop for AI agents via WhatsApp for confirmations, notifications, and interactive questions.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install WhatsApp MCP server

claude mcp add whatsapp -e WHATSAPP_TARGET_NUMBER='<whatsapp-target-number>' -- npx -y @mhrj/whatsapp-mcp

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "<whatsapp-target-number>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "<whatsapp-target-number>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "whatsapp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "<whatsapp-target-number>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "<whatsapp-target-number>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
WHATSAPP_TARGET_NUMBER	yes	—	Target WhatsApp number (required)
WHATSAPP_ALLOWED_NUMBERS	—	—	Comma-separated JIDs to restrict who can control replies

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-06-15 · 4mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-03-25 · 7mo ago · official registry · v2.0.1

FAQ

›How do I install the WhatsApp MCP server in Claude Code?

Run: claude mcp add whatsapp -e WHATSAPP_TARGET_NUMBER='<whatsapp-target-number>' -- npx -y @mhrj/whatsapp-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does WhatsApp require an API key?

Yes. It expects WHATSAPP_TARGET_NUMBER.

›Can I use WhatsApp as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is WhatsApp in the official MCP registry?

Yes, as io.github.meharajM/whatsapp-mcp.