WhatsApp MCP Server

MCPOpen SourceMIT12.0

by TharanaBope • Messaging & Collaboration

An MCP server that connects a personal WhatsApp account to LLM agents so they can search, read, and send messages (including media).

Example Use Cases

1
Access and search a personal WhatsApp message history (including images, videos, documents, and audio) stored locally.
2
Send messages or media (images, videos, documents, voice notes) to individuals or groups via a linked personal WhatsApp account.
3
Download media and retrieve contextual message threads and metadata to perform conversation-aware actions.

Description

WhatsApp MCP Server links a Go WhatsApp bridge (using whatsmeow) with a Python Model Context Protocol (MCP) server to let agents like Claude or Cursor interact with your personal WhatsApp data. It stores message history locally in SQLite and exposes tools to search contacts, list messages/chats, send messages or files, and download media on demand. Media handling includes automatic audio conversion via FFmpeg for voice messages and explicit download endpoints for stored media. This setup keeps data local and only shares message content with an LLM when an agent invokes the provided tools.

Quick Actions

View on GitHub

Security

Scanned 2 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

D45/100

4/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities0 Tools / 0 Prompts / 0 Resources

OwnerTharanaBope

CategoryMessaging & Collaboration

DependenciesStandalone