💬 WhatsApp MCP Server
Connect Claude AI to WhatsApp — Search, Read & Send Messages with AI
The most powerful open-source WhatsApp integration for Claude AI and other MCP-compatible assistants.
Search conversations • Send messages • Share media • React to messages • All through natural language.
Quick Start · Features · Documentation · FAQ
Example: Using Claude to interact with WhatsApp contacts naturally
🎯 Why WhatsApp MCP Server?
| Problem | Solution |
|---------|----------|
| 🔒 Privacy concerns with cloud-based WhatsApp APIs | All data stored locally in SQLite — nothing leaves your machine unless you ask |
| 🤖 No AI integration with WhatsApp | Direct Claude AI integration via Model Context Protocol |
| 💰 Expensive third-party WhatsApp APIs | 100% free and open-source, connects to your personal account |
| 🔧 Complex setup for WhatsApp automation | Simple 3-step installation — clone, run, connect |
[!NOTE]
This connects to your personal WhatsApp account via the official WhatsApp Web protocol. Your messages are stored locally and only sent to Claude when you explicitly request it through MCP tools.
✨ Features
📱 Messaging
- ✅ Send text messages to contacts & groups
- ✅ Search message history with filters
- ✅ Get conversation context
- ✅ React to messages with emojis
- ✅ View chat metadata & info
|
📎 Media Support
- ✅ Send images, videos & documents
- ✅ Send voice messages (auto-converts audio)
- ✅ Download received media files
- ✅ FFmpeg auto-conversion for audio
- ✅ All major formats supported
|
🔍 Smart Search
- ✅ Search contacts by name or number
- ✅ Filter messages by date & sender
- ✅ Find specific conversations
- ✅ Get last interaction with contact
- ✅ Full-text message search
|
🔐 Privacy & Security
- ✅ Local SQLite database storage
- ✅ API key authentication
- ✅ No cloud dependencies
- ✅ You control what Claude sees
- ✅ Directory traversal protection
|
🚀 Quick Start
Get up and running in under 5 minutes:
# 1. Clone the repository
git clone https://github.com/hemangjoshi37a/hjLabs.in-whatsapp-mcp-server.git
cd hjLabs.in-whatsapp-mcp-server
# 2. Start the WhatsApp bridge (scan QR code with your phone)
cd whatsapp-bridge && go run main.go
# 3. Configure Claude Desktop (see Installation section below)
📦 Installation
Prerequisites
| Requirement | Version | Purpose |
|-------------|---------|---------|
| Go | 1.21+ | WhatsApp bridge runtime |
| Python | 3.11+ | MCP server runtime |
| UV | Latest | Python package manager |
| Claude Desktop | Latest | Or Cursor IDE |
| FFmpeg | Optional | Audio format conversion |
📥 Install UV (Python package manager)
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
... [View full README on GitHub](https://github.com/hemangjoshi37a/hjLabs.in-whatsapp-mcp-server#readme)
