Overview
WhatsApp MCP Server couples a Go-based WhatsApp-Web bridge with a Python MCP layer, giving LLM agents controlled, local access to your chats. Messages are cached in SQLite and only surfaced to the model when tools are invoked, preserving privacy while enabling rich conversational workflows.
Key Capabilities
- Chat & contact search – fuzzy-search contacts, groups and message history with optional context windows.
- Send messages & media – text, images, video, documents and voice notes (auto-converted via FFmpeg).
- Context retrieval tools – list recent messages, fetch interaction context, download media binaries on demand.
- Local-only storage – full history retained in SQLite; nothing leaves the machine unless explicitly requested.
- QR-code authentication – quick multi-device sign-in via WhatsApp Web, with periodic re-auth handling.
