Overview
What is Whatsapp?
The WhatsApp MCP server is a Node.js application that enables programmatic interaction with the WhatsApp desktop application on macOS using AppleScript automation. It provides a simple interface for sending messages and checking WhatsApp status without requiring direct UI interaction. It is built for developers who want to integrate WhatsApp messaging into AI workflows.
How to use Whatsapp?
Install the server by cloning the repository and running npm install, then start it with node index.js. Configure it in Claude Desktop by adding a claude_desktop_config.json entry with the command and path to index.js. Once integrated, invoke tools such as send-whatsapp-message or check-whatsapp-status via an MCP client.
Features of Whatsapp
- Send text messages to specific WhatsApp contacts.
- Check if the WhatsApp desktop application is running.
- List recent contacts (limited due to WhatsApp privacy).
- Uses AppleScript for macOS automation.
- Comprehensive error logging to file and console.
- Implements MCP stdio transport for tool communication.
Use cases of Whatsapp
- Let an AI assistant send a WhatsApp message on your behalf.
- Verify WhatsApp is running before attempting to send messages.
- Automate routine WhatsApp messages from a script or chatbot.
- Integrate WhatsApp messaging into a larger MCP‑powered toolchain.
FAQ from Whatsapp
What operating system does it require?
It requires macOS because it relies on AppleScript to automate the WhatsApp desktop application.
What are the runtime requirements?
You need Node.js v14.0.0 or higher, the WhatsApp desktop application installed, and an internet connection.
How does it handle WhatsApp's privacy protections?
The list‑recent‑contacts tool informs users about WhatsApp’s privacy limitations and requires exact contact names for messaging.
Where are logs stored?
Logs are written to ~/Library/Logs/whatsapp-mcp/ in addition to console output.
What transport does it use?
It uses stdio transport as part of the Model Context Protocol (MCP).
