WhatsApp Agent MCP Server
Kenneth0416/whatsapp-agent
Automação de WhatsApp Web via MCP para agentes de IA
Ver no GitHubServidor MCP que expõe WhatsApp Web como ferramenta nativa para agentes de IA (como Claude), permitindo automação de envio/recebimento de mensagens via injeção na API interna do WhatsApp. Implementa persistência de sessão com SQLite e oferece também uma versão desktop com Electron.
Instalação
npx convez-ai Kenneth0416/whatsapp-agent1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar WhatsApp com fluxos de trabalho de agentes de IA
- Automação de respostas e gerenciamento de conversas em massa
- Sincronização de mensagens WhatsApp com sistemas internos
Veredito

Projeto pessoal de qualidade técnica sólida (TypeScript, Playwright, SQLite, MCP), mas com restrição legal clara: não é open-source e proíbe uso/distribuição. Viável apenas como referência arquitetural ou para fork privado com consentimento do autor.
README
A tradução para o português deste README ainda está na fila.
WhatsApp Agent
⚠️ Personal, non-open-source project — All Rights Reserved. The source is published publicly for reference/demonstration only. It is not open source. No license to use, copy, modify, or distribute is granted. See LICENSE.
A WhatsApp Web automation agent that injects into WhatsApp Web's internal API (via @wppconnect/wa-js) to receive, store, and send messages — driven by an AI agent instead of fragile DOM scraping.
This repository contains two implementations:
mcp-version/ — MCP Server
Exposes WhatsApp as an MCP (Model Context Protocol) server so Claude Code and other AI agents can operate WhatsApp as a native tool.
- Browser automation: Playwright (persistent Chromium context)
- WhatsApp API:
@wppconnect/wa-jsinjected into WhatsApp Web - Storage: SQLite (
better-sqlite3) - Interface: MCP server (
@modelcontextprotocol/sdk) - Tools:
send_message,list_chats,get_history,get_stats,get_new_messages,logout
cd mcp-version
npm install
npm run login # scan QR once; session is persisted
npm run start # start MCP server
pi-version/ — Desktop App (Electron)
A standalone Electron desktop app with a chat UI, built on the Pi agent runtime
(@earendil-works/pi-agent-core).
- Shell: Electron + Vite + React
- Agent runtime:
@earendil-works/pi-ai/pi-agent-core - WhatsApp API:
@wppconnect/wa-js - Storage: SQLite (
better-sqlite3)
cd pi-version
npm install
npm run dev # run in development
npm run package # build a distributable (electron-builder)
Notes
- Requires a logged-in WhatsApp session (QR scan on first run).
- Session credentials (
.wa-session/), local databases (*.db), and.envare git-ignored and never committed. - This automates WhatsApp Web; use it in accordance with WhatsApp's Terms of Service and at your own risk.
License
Copyright (c) 2026 Kenneth Kwok. All Rights Reserved. Non-open-source. See LICENSE.