whatsapp-mcp

whatsapp-mcp

3.8

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 users to interact with their WhatsApp messages and contacts through an LLM like Claude.

The WhatsApp MCP Server is designed to facilitate seamless interaction with WhatsApp through a Model Context Protocol server. It allows users to search and read personal WhatsApp messages, including media files, and send messages to individuals or groups. The server connects directly to a personal WhatsApp account via the WhatsApp web multidevice API using the whatsmeow library. Messages are stored locally in a SQLite database and are only sent to an LLM when accessed through controlled tools. The server supports sending and receiving various media types and integrates with platforms like Claude and Cursor for enhanced AI-driven communication.

Features

  • Direct connection to personal WhatsApp account via WhatsApp web multidevice API.
  • Local storage of messages in a SQLite database with controlled access to LLM.
  • Support for sending and receiving media files including images, videos, documents, and audio messages.
  • Integration with Claude and Cursor for AI-driven communication.
  • Automatic conversion of audio files to WhatsApp-compatible formats using FFmpeg.

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 chats and their 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 specified recipient

  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