whatsapp-mcp

whatsapp-mcp

3.2

If you are the rightful owner of whatsapp-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a Model Context Protocol (MCP) server for WhatsApp, allowing interaction with personal WhatsApp messages and contacts.

The WhatsApp MCP Server is designed to facilitate interaction with personal WhatsApp accounts through the WhatsApp web multidevice API. It allows users to search and read messages, send messages and media files, and manage contacts. The server connects directly to a personal WhatsApp account using the whatsmeow library, storing messages locally in a SQLite database. This setup ensures that messages are only sent to an LLM when accessed through controlled tools. The server is implemented using a Go application for the WhatsApp bridge and a Python server for the MCP protocol, providing a seamless integration with platforms like Claude and Cursor.

Features

  • Direct connection to personal WhatsApp account via WhatsApp web multidevice API.
  • Local storage of messages in a SQLite database for privacy and control.
  • Capability to send and receive various media types including images, videos, and audio messages.
  • Integration with LLMs like Claude for enhanced interaction with WhatsApp data.
  • Support for media conversion using FFmpeg for optimal compatibility.

Tools

  1. search_contacts

    Search for contacts by name or phone number

  2. list_messages

    Retrieve messages with optional filters and context

  3. list_chats

    List available chat history and its metadata

  4. get_chat

    Get information for specific chats

  5. get_direct_chat_by_contact

    Find direct chats with specific contacts

  6. get_contact_chats

    List all chats involving a specific contact

  7. get_last_interaction

    Get the latest news with contacts

  8. get_message_context

    Retrieve the context of a specific message

  9. send_message

    Send WhatsApp messages to the specified phone number or group JID

  10. send_file

    Send files (pictures, videos, original audio, document) to the designated recipients

  11. send_audio_message

    Send audio files as WhatsApp voice messages (requires the file in .ogg opus format or install ffmpeg)

  12. download_media

    Download media from WhatsApp messages and get local file path