whatsapp-mcp-server
Provides MCP access to WhatsApp for reading incoming messages, searching contacts by name or number, and sending text messages. AI developers integrate it with Claude or Cursor to build messaging automation. Used for chatbots, customer support replies, and contact-based notifications.
Overview
whatsapp-mcp-server implements the Model Context Protocol (MCP) for WhatsApp integration, enabling AI assistants like Claude and Cursor to interact directly with WhatsApp accounts. It exposes core functions for message retrieval, contact lookup, and outbound messaging without requiring native WhatsApp APIs or web automation.
Key Capabilities
- read_messages: Fetches recent or specified messages from individual chats or groups, including sender details, timestamps, and content.
- search_contacts: Queries WhatsApp contact list by name, phone number, or partial matches, returning profile info and chat status.
- send_messages: Delivers text messages to contacts or groups, supporting basic formatting and delivery confirmation.
These capabilities run through a linked WhatsApp account, handling authentication via QR code scan or session persistence.
Use Cases
-
Customer Support Automation: read_messages detects new inquiries in a support group, search_contacts retrieves customer details, then send_messages delivers AI-generated responses.
-
Personal Assistant Bot: read_messages monitors for reminders or queries, uses search_contacts for recipient lookup, and send_messages to confirm actions or share updates.
-
Sales Outreach Tool: search_contacts identifies leads from CRM data, combined with send_messages for personalized follow-ups based on recent read_messages history.
-
Notification Relay: read_messages from email/Slack triggers send_messages to WhatsApp users, with search_contacts ensuring accurate delivery.
Who This Is For
AI developers and automation engineers building WhatsApp-enabled applications. Targets users of MCP-compatible IDEs like Cursor or agents like Claude needing reliable messaging I/O. Ideal for indie devs prototyping bots or teams extending AI workflows with real-time comms.