A secure implementation of the Model Context Protocol (MCP) for WhatsApp, designed for local execution. This tool provides a controlled environment for automating WhatsApp interactions with a strong emphasis on data security and privacy.
Your PC ← → WhatsApp Bridge ← → Claude ← → You!!!!!!
- 💬 Automated Messaging: Send and receive WhatsApp messages through Claude
- 🔒 Security First:
- Database encryption with SQLite + SQLCipher
- Secure token authentication
- Process isolation
- Secure credential management
- 📊 Comprehensive Logging: Full audit trail of all activities
- 🔄 Easy Integration: Simple setup process with Claude Desktop
- Windows 10/11 or Linux
- Go 1.21+
- Python 3.10+
- FFmpeg (optional, for audio messages)
# Clone the repository
git clone https://github.com/Charlesagui/mcp-whats-app.git
cd whatsapp-mcp-secure
# Run setup as Administrator
.\scripts\setup.ps1 -All# Double-click this file or run in terminal:
scripts\start.bat- Two new windows will open
- One will show a QR code
- Scan it with your phone (WhatsApp > Linked Devices)
# Run this just once:
python mcp-server\configure_claude.py- Then restart Claude Desktop
- Wait 30 seconds before testing
In Claude, try:
Send a WhatsApp to [contact name] saying "Hello from Claude"
"Send WhatsApp to John: 'Meeting at 3pm'"
"Send to +549123456789: 'Running late, be there in 10'"
"Show my WhatsApp contacts"
"Search contacts containing 'Maria'"
"Is WhatsApp connected?"
"Show recent messages"
- Close all WhatsApp Web sessions in your browser
- Run
scripts\start.batagain - Wait 30 seconds for QR code to appear
- Ensure both server windows are running
- Run:
python mcp-server\configure_claude.py - Restart Claude Desktop
- Wait 1 minute before testing
# Windows
netstat -ano | findstr :8081
taskkill /PID [process_id] /F- For personal and educational use only
- Do not send spam or malicious content
- Keep software updated
- Monitor logs regularly
Found a bug or have a question? Please open an issue in the repository.
If you find this project useful, consider supporting its development:
MIT License - See the LICENSE file for details.