A
licenseA
qualityB
maintenanceEnables Claude to interact with WhatsApp on macOS through the Model Context Protocol. It allows reading messages, searching contacts, listing chats, and sending replies via natural conversation.
8
49 PyPI
2
MIT
ZapMCP
by pedrosoutom
Provides read-only access to WhatsApp Desktop for Mac, enabling listing conversations, reading messages from a period, searching by words, and opening images, documents, and transcribed audio.
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., "@ZapMCPsummarize my WhatsApp chat with João from yesterday"
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.
ZapMCP
Dá ao Claude acesso de leitura ao WhatsApp Desktop do Mac: conversas, imagens, documentos e áudios transcritos. Tudo roda no próprio Mac. Nada se conecta aos servidores do WhatsApp e a pasta do WhatsApp nunca é alterada.
Como funciona
WhatsApp Desktop ──cópia──▶ indexador ──▶ índice local ◀── servidor MCP ◀── ClaudeO ZapMCP copia o banco de dados local do WhatsApp e monta um índice próprio, com busca.
Um servidor MCP oferece ao Claude ferramentas para listar conversas, ler mensagens de um período, buscar por palavras e abrir imagens e documentos.
Os áudios são transcritos no Mac com whisper.cpp. Nenhum áudio sai do computador.
Só leitura: o ZapMCP não envia mensagens.
Related MCP server: imessage-mcp
Como usar
Precisa de macOS com o WhatsApp Desktop logado e do uv
(brew install uv).
git clone https://github.com/pedrosoutom/zapmcp.git
cd zapmcp
npx @anthropic-ai/mcpb pack . dist/ZapMCP.mcpbDepois, no Claude Desktop, abra Ajustes > Extensões e arraste o dist/ZapMCP.mcpb para a página.
Se o macOS negar o acesso à pasta do WhatsApp, libere o Acesso Total ao Disco em **Ajustes do Sistema
Privacidade e Segurança**.
Para usar no Claude Code, comandos de terminal, ajustes da transcrição e limites conhecidos, veja o guia de uso.
Avisos
O ZapMCP lê um banco interno do WhatsApp, sem documentação; uma atualização do app pode quebrar a leitura.
Projeto independente, sem relação com o WhatsApp ou a Meta.
Licença
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
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.
Related MCP Servers
- AlicenseAqualityCmaintenanceA local MCP server that enables reading iMessage conversations and sending new messages through Claude Desktop. It provides secure, read-only access to your Mac's iMessage database and AppleScript-based message sending capabilities.6MIT
- AlicenseNot gradedqualityDmaintenanceGives Claude Desktop read-only access to your WhatsApp chats and message history via a local MCP server.6 npm3MIT
- AlicenseAqualityDmaintenanceEnables Claude to read and search WhatsApp messages, transcribe voice notes, and analyze images locally through a read-only bridge.19MIT