
Whatsapp Macos
This server lets Claude read from and send messages through your local WhatsApp on macOS. It queries the WhatsApp SQLite database directly for reading operations like searching contacts, listing chats, pulling message history, and filtering by date or keyword. For sending messages, it spins up a Node.js bridge that connects to WhatsApp Web using the Baileys library, requiring QR code authentication. The read side works offline and immediately. The send side needs the bridge running. You'd reach for this when you want Claude to triage unread messages, search old conversations for context, or draft and send replies without switching apps.
- GitHub stars
- 2
- tools
- 8
- transport
- STDIO
- last updated
- Apr 14, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
whatsapp_statusCheck connection, get QR if needed
Check connection, get QR if needed
No parameter schema in public metadata yet.
whatsapp_search_contactsSearch contacts by name/phone
Search contacts by name/phone
No parameter schema in public metadata yet.
whatsapp_list_chatsList recent conversations
List recent conversations
No parameter schema in public metadata yet.
whatsapp_get_messagesGet messages from a chat
Get messages from a chat
No parameter schema in public metadata yet.
whatsapp_search_messagesSearch across all chats
Search across all chats
No parameter schema in public metadata yet.
whatsapp_unreadGet unread message summary
Get unread message summary
No parameter schema in public metadata yet.
whatsapp_sendSend a message
Send a message
No parameter schema in public metadata yet.
whatsapp_incomingGet real-time incoming messages
Get real-time incoming messages
No parameter schema in public metadata yet.
Sponsors
Readme
Check it out on https://mcp.paperknife.app/
WhatsApp MCP for macOS
A Model Context Protocol server that connects Claude to your WhatsApp. Ask Claude to catch you up on unread chats, search your message history, or send a reply.
Reading works in about a minute with no QR scan and no Node.js. Sending is optional and needs one extra step.
Features
Search contacts by name or phone number. Read chat history with date filtering. List recent conversations with unread counts. Summarize everything you haven't read yet. Send replies and receive incoming messages once the bridge is connected.
Requirements
- macOS with the WhatsApp desktop app installed and logged in
- Node.js 18+, only if you want to send messages
You don't need to install Python. uvx fetches a suitable version on its own.
Installation
Details
- Repository
- github.com/kalki-kgp/whatsapp-mcp
- Category
- Communication & Messaging
- Package
whatsapp-mcp-macos- Transport
- STDIO
- Registry
- MCP registry, active