Whatsapp MCP

WhatsApp MCP + CLI

Una integración de WhatsApp que funciona de dos maneras:

• Servidor MCP — permite que asistentes de IA como Claude controlen WhatsApp directamente
• Herramienta CLI — envía/lee mensajes de WhatsApp desde tu terminal

Construido sobre whatsapp-web.js.

---

Características

• Envía mensajes de WhatsApp por nombre de contacto o número de teléfono
• Lee mensajes recientes de cualquier chat
• Lista todos los chats recientes con vistas previas
• Busca contactos por nombre
• Funciona como servidor MCP (Claude, etc.) o CLI independiente

---

Configuración

1. Instalar dependencias

npm install

2. Autenticar WhatsApp

node index.js auth

Escanea el código QR con tu aplicación móvil de WhatsApp. Tu sesión se guarda localmente: solo necesitas hacer esto una vez.

---

Servidor MCP (para Claude / asistentes de IA)

El servidor MCP expone 4 herramientas sobre stdio:

Herramienta	Descripción
send_message	Envía un mensaje a un contacto
read_messages	Lee mensajes recientes de un chat
list_chats	Lista chats recientes con vistas previas
search_contacts	Busca contactos por nombre

Configurar en Claude Code

Añade a tu .mcp.json o a la configuración MCP de Claude Code:

{
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["C:/path/to/whatsapp-cli/mcp-server.mjs"]
    }
  }
}

Ejecutar manualmente

node mcp-server.mjs

---

Uso de CLI

Enviar un mensaje

node index.js send --to "John Doe" --message "Hey!"
# or by phone number
node index.js send --to 919876543210 --message "Hey!"

Leer mensajes

node index.js read --from "John Doe" --count 20

Listar chats

node index.js list-chats --count 10

---

Casos de uso

• Asistente de WhatsApp con IA — conéctalo a Claude o a cualquier IA compatible con MCP para leer y enviar mensajes sin usar las manos
• Automatización de WhatsApp — crea bots, auto-respuestas o sistemas de notificación
• Mensajería desde terminal — envía/lee mensajes de WhatsApp sin abrir tu teléfono
• Notificaciones de negocio — envía alertas automáticas de WhatsApp desde scripts o trabajos cron

---

Estructura del proyecto

├── index.js              # CLI entry point
├── mcp-server.mjs        # MCP server (for AI assistants)
├── src/
│   ├── client.js         # WhatsApp client setup
│   └── commands/
│       ├── auth.js       # QR code authentication
│       ├── send.js       # Send message command
│       ├── read.js       # Read messages command
│       └── list-chats.js # List chats command
└── package.json

---

Requisitos

• Node.js 18+
• Una cuenta de WhatsApp (personal o de empresa)

---

Licencia

MIT