WhatsApp MCP Server

WhatsApp MCP Server

MCP server for your personal WhatsApp handling individuals, groups, searching and sending.

5,083
Stars
800
Forks
1
Releases

Overview

This MCP server enables you to search and read your personal WhatsApp messages (including media such as images, videos, documents, and audio) and to send messages to individuals or groups. It connects to your personal WhatsApp account directly via the WhatsApp web multidevice API using the whatsmeow library. All messages are stored locally in a SQLite database within the whatsapp-bridge/store directory and are only exposed to an LLM when accessed through the provided MCP tools. The system comprises two main components: the Go-based WhatsApp Bridge, which handles authentication, message retrieval, and storing history; and the Python-based MCP server, which implements the Model Context Protocol and exposes standardized tools for Claude (or other LLMs) to interact with WhatsApp data. Tools include search_contacts, list_messages, list_chats, get_chat, get_direct_chat_by_contact, get_contact_chats, get_last_interaction, get_message_context, send_message, send_file, send_audio_message, and download_media. Media handling supports images, videos, documents, and audio; audio can be sent as playable voice messages in ogg opus format, converted automatically with FFmpeg if installed. The flow: Claude -> MCP server -> Go bridge/SQLite -> Claude.

Details

Owner
lharries
Language
Go
License
MIT License
Updated
2025-12-07

Features

search_contacts

Search for contacts by name or phone number.

list_chats

List available chats with metadata.

list_messages

Retrieve messages with optional filters and context.

get_chat

Get information about a specific chat.

get_direct_chat_by_contact

Find a direct chat with a specific contact.

get_last_interaction

Get the most recent message with a contact.

send_message

Send a WhatsApp message to a specified phone number or group JID.

download_media

Download media from a WhatsApp message and get the local file path.

Audience

IndividualsSearch/read personal WhatsApp messages and send messages to individual contacts via MCP.
GroupsManage WhatsApp group chats; search/read messages and send messages to groups.

Tags

WhatsAppMCPClaudeWhatsApp bridgeSQLiteGoPythonsearchreadsendmediamultideviceWhatsApp webtools