convez.ai
MCP ServerAutomaçãoAvançado
Kenneth0416

WhatsApp Agent MCP Server

Kenneth0416/whatsapp-agent

Automação de WhatsApp Web via MCP para agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-agent

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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-js injected 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 .env are 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.

Ver o original no GitHub

Bom para

Relacionados