whatsapp-mcp-ts
The WhatsApp MCP Server connects an AI agent to a personal WhatsApp account using TypeScript and the Baileys library. It allows the AI to manage and interact with WhatsApp data, providing tools to search contacts, retrieve chat history, and send messages while ensuring local data storage and privacy.
What is the purpose of the WhatsApp MCP Server?
The server connects personal WhatsApp accounts to AI agents, allowing functionalities like message searching, contact listing, and message sending.
How is user data handled?
All messages and authentication details are stored locally in a SQLite database, ensuring privacy. Data is only shared with the AI agent when explicitly requested.
What are the prerequisites for installation?
You need Node.js version 23.10.0 or higher, npm (or yarn/pnpm), and an AI client like Anthropic Claude Desktop app.
How do I authenticate my WhatsApp account?
Run the server to generate a QR code, scan it using WhatsApp mobile app under Linked Devices, and your credentials will be saved locally.
What should I do if I encounter QR code issues?
Check the console output for the QR code URL and open it manually if it doesn't open automatically. Ensure you scan it promptly with your phone's WhatsApp app.