Cross-platform WhatsApp Model Context Protocol server with multi-account support and optional local Whisper transcription
View on GitHub ↗This is a Model Context Protocol (MCP) server for WhatsApp.
With this server, an MCP client can search and read your WhatsApp messages (including images, videos, documents, and audio), search contacts, and send messages to individuals or groups. It can also send media files.
It connects to one WhatsApp account at a time through WhatsApp's web multi-device API using whatsmeow. Messages are stored locally in SQLite and are returned to an AI client only when it invokes the corresponding MCP tools.
The core bridge and MCP server are designed for macOS, Linux, and Windows. For two or more accounts, run one isolated bridge profile per account. See platform setup and the multi-account guide.
This repository is a maintained fork of Luke Harries' original whatsapp-mcp project. Credit for the original architecture and implementation belongs to Luke Harries and the upstream contributors. The original MIT copyright notice is preserved in LICENSE.
- Supports isolated personal and work accounts with separate stores, ports, identities, and MCP registrations. - Adds explicit confirmation before messages, files, group changes, chat-state changes, blocking, or typing-presence actions are executed. - Expands group, account-identity, contact-resolution, chat-management, media, call-history, and targeted history-synchronization capabilities. - Adds delivery/read receipt tracking and a bounded, replayable Server-Sent Events stream for live messages and receipts. - Improves pairing with native QR image handling, phone-number pairing, clearer linked-device identities, and terminal fallback. -
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/DJNgoma--whatsapp-mcp.html)
Authenticated, self-hosted WhatsApp MCP server that serves 96 tools for the token cost of 29, with a labeled eval for tool-retrieval accuracy. Go bridge + Python FastMCP.
bybit-exchange/kaasTurn scattered notes, docs and transcripts into a queryable Markdown wiki — an LLM knowledge-base compiler with MCP access, no embeddings, self-hosted.
korovin-aa97/talkthrough-mcpMCP server: turn narrated screen recordings into agent-ready data — local Whisper transcript, scene keyframes, OCR, wall-clock anchoring. Record your screen, talk — your AI agent files the bugs.
Vladimir-Human/ru-marketplace-mcpДевять российских маркетплейсов и китайский Taobao как MCP-серверы: Wildberries, Ozon, Яндекс Маркет, Детский мир, Авито, Мегамаркет, Lamoda, DNS, Ситилинк. Плюс сравнение цен по всем сразу. Только чт
aka-kika/hig-mcpMCP server serving Apple Human Interface Guidelines as structured design tokens for AI coding agents — post-WWDC25 system colors, Liquid Glass constraints, SwiftUI mappings.
whoisqwerz/pocket_disasmMulti-session IDALib MCP router for coding agents. Analyze multiple binaries in parallel with IDA-compatible reverse engineering tools.
The top new MCP servers of the week, every Monday. No spam, unsubscribe anytime.