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.

WhatsApp MCP Server

This project provides a Model Context Protocol (MCP) server for WhatsApp, enabling users to manage and interact with their WhatsApp messages through Claude. Features include:

  • Searching and reading personal WhatsApp messages, including media.
  • Sending messages and media files to individuals or groups.
  • Integration with the WhatsApp web API using the whatsmeow library.
  • Local storage of messages in a SQLite database.

Installation

  • Requires Go, Python 3.6+, Anthropic Claude Desktop app, and UV.
  • Optional FFmpeg for audio messages.

Usage

Once set up, users can search contacts, retrieve messages and chats, and send messages and media.

Architecture Overview

  • Go WhatsApp Bridge: Handles WhatsApp API connections and stores messages in SQLite.
  • Python MCP Server: Provides tools for Claude to interact with WhatsApp data.