whatsapp-mcp

whatsapp-mcp

3,854

This project is a Model Context Protocol server for WhatsApp that allows users to search, read, and send messages and media through Claude, with all data securely stored in a local SQLite database. It directly connects to a personal WhatsApp account via the web API.

search_contacts

Search for contacts by name or phone number

list_messages

Retrieve messages with optional filters and context

list_chats

List available chats and their metadata

get_chat

Get information for specific chats

get_direct_chat_by_contact

Find direct chats with specific contacts

get_contact_chats

List all chats involving a specific contact

get_last_interaction

Get the latest news with contacts

get_message_context

Retrieve the context of a specific message

send_message

Send WhatsApp messages to the specified phone number or group JID

send_file

Send files (pictures, videos, original audio, document) to the specified recipient

send_audio_message

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

download_media

Download media from WhatsApp messages and get local file path