Provides tools for interacting with WhatsApp, allowing users to read chat messages, send text and file messages, search contacts, and monitor connection status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@claude-whatsapp-mcp send a message to Sarah saying I'll be 10 minutes late"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
WhatsApp MCP server for Claude Code. Read messages, send replies, search contacts — all from your terminal.
Built with whatsapp-web.js and the Model Context Protocol.
Give Claude Code direct access to your WhatsApp:
Read chats — "check my unreads", "what did Ali say?"
Send messages — "send John the proposal PDF"
Search contacts — "find Sarah's number"
Connection management — QR code auth, session persistence
Related MCP server: WhatsApp MCP for macOS
git clone https://github.com/ferazfhansurie/claude-whatsapp-mcp.git
cd claude-whatsapp-mcp
npm installAdd this to your Claude Code MCP settings (~/.claude.json or project .mcp.json):
{
"mcpServers": {
"whatsapp": {
"command": "node",
"args": ["/path/to/claude-whatsapp-mcp/src/index.js"]
}
}
}In Claude Code, just say:
connect to whatsappClaude will initialize the server and show you a QR code. Scan it with your phone (WhatsApp > Settings > Linked Devices > Link a Device).
Your session persists in .wwebjs_auth/ — you only need to scan once.
Tool | Description |
| Connect to WhatsApp or check status. Shows QR if needed. |
| Send text + optional file attachment |
| List recent chats with unread counts |
| Read messages from a specific chat |
| Search contacts by name or number |
| Connection status + unread summary |
# Check unreads
"do I have any unread WhatsApp messages?"
# Read a specific chat
"what's the latest in my family group?"
# Send a message
"send Ali a message saying the meeting is at 3pm"
# Send a file
"send the invoice PDF to +60123456789"
# Search contacts
"find contacts named Sarah"Node.js 18+
Claude Code with MCP support
A WhatsApp account
The server runs whatsapp-web.js locally on your machine — the same tech as WhatsApp Web. Your messages stay on your device. Nothing is sent to any external server.
On first run, it generates a QR code for linking. After that, the session is cached and reconnects automatically.
MIT
Built by Adletic Agency
This server cannot be deployed
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
Your own WhatsApp in Claude and ChatGPT: read chats, draft replies, send messages you approve.
Ask questions across your WhatsApp inbox from Claude, ChatGPT, Cursor or any MCP client.
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
