mcpbeat Sign in

Whatsapp MCP Server

local only

Whatsapp MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 104 installs a week from npm. Last commit 15 Jun 2026.

WhatsApp MCP Server - Human-in-the-loop for AI agents via WhatsApp

Installs per day peak 32 · avg 7 · +333% w/w
a month agotoday
104
Installs / week
npm · @mhrj/whatsapp-mcp
0
Stars
1 open issue
15 Jun 2026
Last commit
no releases in 90 days
ISC
License
TypeScript

Nothing serious here today

Today is the operative word: we check Whatsapp MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add whatsapp-mcp -e 'WHATSAPP_TARGET_NUMBER=<WHATSAPP_TARGET_NUMBER>' -- npx -y @mhrj/whatsapp-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.whatsapp-mcp]
command = "npx"
args = ["-y", "@mhrj/whatsapp-mcp"]
env = { WHATSAPP_TARGET_NUMBER = "<WHATSAPP_TARGET_NUMBER>" }
.cursor/mcp.json
{
  "mcpServers": {
    "whatsapp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "whatsapp-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mhrj/whatsapp-mcp"
      ],
      "env": {
        "WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
      }
    }
  }
}

Put your own value in place of <WHATSAPP_TARGET_NUMBER> (Target WhatsApp number (required)). The author’s registry entry marks it as required.

Optional settings from the registry entry, left out of the block above: WHATSAPP_ALLOWED_NUMBERS (Comma-separated JIDs to restrict who can control replies).

Alternatives to Whatsapp MCP

same job, measured the same way
pingwa
by grzgrzgrz3

Zero-setup WhatsApp notifications + human-in-the-loop for AI agents — text 'join', send in 60s.

71 installs/wk 5 tools answering
Hubd
by bzdos

The project tracker for teams of humans and AI agents — in plain files. MCP server + CLI.

82 installs/wk local only
Lassare
by lassare

Human-in-the-loop for AI coding agents — ask questions, get approvals via Slack.

answering
MCP Z API
by codespar

MCP server for Z-API — WhatsApp messaging, contacts, media

72 installs/wk local only
MCP Whatsapp Cloud
by codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

57 installs/wk local only
WhoisXML API MCP Server
by whois-api-llc

35 WHOIS, DNS, IP, threat intelligence, email, and bulk tools for AI agents via WhoisXML API.

1 259 installs/wk answering
Gambot - Official WhatsApp Business API
by gambot-ai

Official WhatsApp Business API MCP server for AI agents: messages, templates, webhooks, CRM.

405 installs/wk local only
MCP Evolution API
by codespar

MCP server for Evolution API — WhatsApp messaging, instances, contacts

86 installs/wk local only

Whatsapp MCP — questions

Answers built from our own checks of this server.

Why is there no uptime for Whatsapp MCP?
Whatsapp MCP runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @mhrj/whatsapp-mcp was installed 104 times last week.
How do I connect Whatsapp MCP?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @mhrj/whatsapp-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Whatsapp MCP?
The npm package @mhrj/whatsapp-mcp was installed 104 times in the last week. Week over week that is +333%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Whatsapp MCP open source?
Yes — it is published under the ISC licence, written in TypeScript, 0 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.