Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"whatsapp-mcp-macos": {
"args": [
"-y",
"whatsapp-mcp-macos"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
An MCP (Model Context Protocol) server that lets AI assistants control the native WhatsApp macOS app via accessibility APIs.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'whatsapp-mcp-macos' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked whatsapp-mcp-macos against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in other
MCP server for Spanning Cloud Backup — M365/GWS/Salesforce backups, restores, audit.
AI agent control of 3D printers — 432 tools for OctoPrint, Moonraker, Bambu, Prusa, Elegoo
MCP server for Kaseya Autotask PSA — companies, tickets, projects, time entries, and more.
On-chain provenance lookup for AnchorRegistry. Resolve AR-IDs, hashes, and full trees. Authless.
MCP Security Weekly
Get CVE alerts and security updates for Whatsapp Mcp Macos and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
An MCP (Model Context Protocol) server that lets AI assistants control the native WhatsApp macOS app via accessibility APIs.
npm install -g whatsapp-mcp-macos
git clone https://github.com/m13v/whatsapp-mcp-macos.git
cd whatsapp-mcp-macos
swift build -c release
Add to your Claude Code config (~/.claude.json under mcpServers):
"whatsapp": {
"type": "stdio",
"command": "whatsapp-mcp",
"args": [],
"env": {}
}
"whatsapp": {
"type": "stdio",
"command": "/path/to/whatsapp-mcp-macos/.build/release/whatsapp-mcp",
"args": [],
"env": {}
}
Then restart Claude Code or run /mcp to reconnect.
| Tool | Description |
|---|---|
whatsapp_status | Check if WhatsApp is running and accessibility is granted |
whatsapp_start | Launch WhatsApp if not running |
whatsapp_quit | Quit WhatsApp (graceful + force fallback) |
whatsapp_search | Search contacts/chats, returns indexed structured results |
whatsapp_open_chat | Click the Nth search result to open a chat |
whatsapp_get_active_chat | Get current chat name, subtitle, and recent messages |
whatsapp_send_message | Send message in current chat with delivery verification |
whatsapp_read_messages | Read messages from current chat |
whatsapp_scroll_search | Scroll search results to load more |
whatsapp_list_chats | List sidebar chats with unread counts |
whatsapp_navigate | Switch tabs (chats, calls, updates, settings) |
The recommended workflow for sending a message:
1. whatsapp_search("contact name") → returns indexed results
2. whatsapp_open_chat(index: 0) → clicks result, returns active chat name
3. whatsapp_get_active_chat() → verify correct chat + see recent messages
4. whatsapp_send_message("hello!") → sends with delivery verification
This MCP server uses macOS accessibility APIs (AXUIElement) to interact with the WhatsApp Catalyst app. It:
MIT