WhatsApp MCP Server

Example Use Cases

• 1

  Search and retrieve personal WhatsApp message history stored locally for context-aware responses.

• 2

  Find and contact people by name or phone number and resolve direct or group chats before sending messages.

• 3

  Send messages from a personal WhatsApp account through an automated workflow while keeping message data stored locally.

Description

This project provides a Python MCP server plus a Go bridge that connects to your personal WhatsApp account using the whatsmeow library and the WhatsApp Web multi-device API. All messages are stored locally in a SQLite database and the MCP server exposes tools (search_contacts, list_messages, send_message, etc.) so LLM agents like Claude can safely query and act on your WhatsApp data. Authentication is done via QR code and the bridge keeps the local database in sync with WhatsApp. The design emphasizes local storage and controlled access so only agent tool calls you allow send message content to an LLM.