whatsapp-mcp
This project is a Model Context Protocol server for WhatsApp that allows users to search, read, and send messages and media through Claude, with all data securely stored in a local SQLite database. It directly connects to a personal WhatsApp account via the web API.
What happens if the QR code doesn't display during authentication?
Try restarting the authentication script. Ensure your terminal supports QR code display.
How do I handle device limit issues with WhatsApp?
Remove an existing device from WhatsApp on your phone under Settings > Linked Devices.
What should I do if my WhatsApp messages are out of sync?
Delete the database files in the whatsapp-bridge/store directory and restart the bridge to re-authenticate.
Is FFmpeg necessary for audio messages?
FFmpeg is optional but required for converting non-Opus audio files to the .ogg format for WhatsApp voice messages.
How is data privacy maintained?
Messages are stored locally and only sent to an LLM when accessed through controlled tools.