Local MCP server that exposes WhatsApp as 4 tools for Claude — send, read, and search messages via Baileys + SQLite. Single-user, no cloud, QR-based auth.
A local Model Context Protocol (MCP) server that exposes your personal WhatsApp account as four tools for Claude Desktop or Claude Code. Backed by Baileys for the WhatsApp Web protocol and better-sqlite3 for the local message cache.
Single-user, local, no cloud dependencies. Once you scan the QR code once, your session is saved and you don't have to scan again.
Tool What it does ------ listchats Recent WhatsApp conversations, newest first. Optional JID-prefix filter (e.g. 120363 for groups). readmessages Last N messages from a chat. Pagination via beforeTimestamp. Optional sender filter. searchmessages FTS5 full-text search over message history with relevance ranking. Supports pizza, pizza OR burger, piz, "exact phrase". sendmessage Send a text message via WhatsApp. The sent message is also persisted locally so subsequent reads/searches return it.
- Node.js 18+ (this project uses ESM and modern Node APIs) - A WhatsApp account on your phone (you'll scan a QR code once) - A C/C++ toolchain for better-sqlite3 native build: - macOS: Xcode Command Line Tools (xcode-select --install) - Linux: build-essential + python3 - Windows: Visual Studio Build Tools with the "Desktop development with C++" workload
The package lives on NPM at @muhammadmustafa18/whatsapp-mcp-server.
⚠️ Don't confuse with whatsapp-mcp-server (no scope) — that's a different package by BitNex Technologies that talks to the WhatsApp Business Cloud API instead of WhatsApp Web. Always use the scoped name with @muhammadmustafa18/.
From the project README.
Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:
[](https://mcp.liqiwa.com/s/MuhammadMustafa18--whatsapp-mcp-server.html)
MCP server for Claude Desktop and other Model Context Protocol clients — sandboxed filesystem access (read/write/edit/search) plus Dev Mode-gated shell command execution, scoped to a single workspace
luckeyfaraday/frontier-orchestratorMulti-agent orchestration for Claude Code: MCP server + skill that keeps Claude as lead engineer while delegating backend work to OpenAI Codex and frontend/design work to Kimi
xfloukiex-lab/pandaclipOne local-first MCP server for agent working state — clipboard history & snippets, TTL cache, file-organizer overlay, and a knowledge graph — plus a live desktop activity lens. 40 tools, SQLite everyw
dhavanikgithub/chartbrew-mcpChartbrew + AI agents. MCP server exposing Chartbrew's documented API: teams, connections, datasets, dashboards, charts, live queries, and secure embedding. TypeScript · stdio · restricted/unrestricte
0xwilliamortiz/openclaude-improvedruns anywhere. uses anything
0xsline/OpenChatCutLocal-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion-powered rendering.
The top new MCP servers of the week, every Monday. No spam, unsubscribe anytime.