Whatsapp MCP
WhatsApp MCP Server - Human-in-the-loop for AI agents via WhatsApp
- Pricing
- Open source
- Runs
- Locally
- Version
- 2.0.1
- Listing updated
- 4 days ago
About Whatsapp MCP
Whatsapp MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add whatsapp-mcp --env WHATSAPP_TARGET_NUMBER='<WHATSAPP_TARGET_NUMBER>' -- npx -y @mhrj/whatsapp-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"whatsapp-mcp": {
"command": "npx",
"args": [
"-y",
"@mhrj/whatsapp-mcp"
],
"env": {
"WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"whatsapp-mcp": {
"command": "npx",
"args": [
"-y",
"@mhrj/whatsapp-mcp"
],
"env": {
"WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"whatsapp-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mhrj/whatsapp-mcp"
],
"env": {
"WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"whatsapp-mcp": {
"command": "npx",
"args": [
"-y",
"@mhrj/whatsapp-mcp"
],
"env": {
"WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"whatsapp-mcp": {
"command": "npx",
"args": [
"-y",
"@mhrj/whatsapp-mcp"
],
"env": {
"WHATSAPP_TARGET_NUMBER": "<WHATSAPP_TARGET_NUMBER>"
}
}
}
}Configuration
WHATSAPP_TARGET_NUMBERTarget WhatsApp number (required)RequiredWHATSAPP_ALLOWED_NUMBERSComma-separated JIDs to restrict who can control replies
Pricing
Open source
Whatsapp MCP FAQ
Is Whatsapp MCP free?
Yes. Whatsapp MCP is open source, so you can use and self-host it for free.
How do I add Whatsapp MCP to Claude Code?
Run this command in your terminal: claude mcp add whatsapp-mcp --env WHATSAPP_TARGET_NUMBER='<WHATSAPP_TARGET_NUMBER>' -- npx -y @mhrj/whatsapp-mcp
What are the best alternatives to Whatsapp MCP?
The closest alternatives to Whatsapp MCP are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to Whatsapp MCP

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity