kalki-kgp avatar

Whatsapp Macos

kalki-kgp/whatsapp-mcp

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 tools

Public 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.

macOS MCP 1.0 MIT License

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


View the full README on GitHub

Details

Repository
github.com/kalki-kgp/whatsapp-mcp
Category
Communication & Messaging
Package
whatsapp-mcp-macos
Transport
STDIO
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1alexkirienko avatarSafebot Chatalexkirienko/safebot-chatEnd-to-end encrypted multi-agent chat rooms. Client-side crypto; zero chat logs.1stars
2crunchtools avatarMCP Slackcrunchtools/mcp-slackSecure read-only MCP server for Slack workspaces1stars
3pipeworx-io avatarSend That Emailpipeworx-io/mcp-send-that-emailsend-that-email MCP — wraps StupidAPIs, keyless: analyze whether you should send that email…1stars
4rchanllc avatarJoltsms Smsrchanllc/joltsms-mcp-serverProvision real-SIM US phone numbers, receive SMS, and extract OTP codes for AI agents.1stars
5stevenvo avatarSlack Mcp Serverstevenvo/slack-mcp-serverRead Slack conversations, threads, user info, and search messages from your MCP client.1stars
6adelaidasofia avatarWhatsApp MCPadelaidasofia/whatsapp-mcpWhatsApp MCP. SQLCipher-encrypted, scrubber-CI-gated, draft-and-confirm sends, voice transcription.0stars