Enables sending and receiving WhatsApp messages, including photos and files, with auto-response capabilities and context management.
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., "@whatsapp-claude-code send a WhatsApp message to John: meeting at 3"
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.
Bot de WhatsApp que responde con Claude. Funciona como servicio 24/7 — no necesitas tener Claude Code abierto.
Le escribes por WhatsApp y Claude te responde. Mantiene contexto entre mensajes, puede ejecutar comandos en tu servidor, enviar archivos, y recibir fotos.
Tu (WhatsApp) → Bridge (servicio) → Claude CLI → respuesta por WhatsAppRelated MCP server: WhatsApp MCP Server
Pega esto en Claude Code:
Instala el MCP de WhatsApp para Claude Code:
1. Clona https://github.com/snestors/mcp_whatsapp-cluade-code en una carpeta permanente
2. Instala deps: PUPPETEER_SKIP_DOWNLOAD=true npm install
3. Crea config.json desde config.example.json. Preguntame:
- Mi numero de WhatsApp (con codigo de pais, sin +)
- Donde tengo Chromium (busca con "which chromium" o "which google-chrome")
4. Crea system-prompt.md desde system-prompt.example.md. Preguntame que contexto quiero darle al bot.
5. Crea el servicio systemd whatsapp-bridge apuntando a bridge.cjs
6. Habilita e inicia el servicio
7. Agrega el MCP whatsapp a mi ~/.claude.json apuntando a index.js
8. Dime que abra http://<mi-ip>:<qr_port> para escanear el QR con WhatsAppEso es todo. Claude Code hace el resto.
Node.js 18+
Chromium o Chrome
Claude Code CLI instalado y autenticado
Desde WhatsApp:
Escribirle y recibe respuesta (con "escribiendo..." mientras piensa)
Enviar fotos y archivos
Responder a mensajes (incluye el contexto)
/reset para nueva conversacion
Desde Claude Code (tools MCP):
send_message — enviar mensaje
check_new_messages — ver mensajes nuevos
get_messages — historial
get_status — estado de conexion
mark_read / mark_all_read — marcar como leidos
Desde scripts/cron:
./notify.sh 584121234567 "La descarga termino!"config.json:
Campo | Default | Que es |
|
| Numeros que pueden hablarle (vacio = todos) |
|
| Responder automaticamente con Claude |
|
| Segundos maximo mostrando "escribiendo..." |
|
| Puerto web para escanear QR |
|
| Puerto API interno |
|
| Ruta a Chromium/Chrome |
system-prompt.md: El contexto que Claude tiene sobre tu sistema. Ponle lo que quieras — que servicios corres, rutas importantes, como quieres que responda.
+-----------------------+
| Claude Code |
| (usa tools MCP) |
+----------+------------+
|
stdio (MCP)
|
+----------v------------+
| index.js (MCP) |
| Liviano, sin estado |
+----------+------------+
|
HTTP :3457
|
+-------------+ +--------------v--------------+ +-------------+
| WhatsApp | <-------> | bridge.cjs (systemd) | -------> | Claude CLI |
| (telefono) | wwebjs | Chromium + SQLite + Express| spawn | --resume |
+-------------+ | QR server :3456 | +------+------+
+-----------------------------+ |
| Responde por
| send_message
+----v----+ (via MCP)
| SQLite |
| messages|
+---------+Flujo de auto-respuesta:
Llega mensaje de WhatsApp al Bridge
Bridge muestra "escribiendo..." y llama a claude -p --resume <session>
Claude procesa con el system prompt y herramientas MCP disponibles
La respuesta se envia de vuelta por WhatsApp
La sesion persiste entre mensajes (contexto continuo)
El sistema tiene 3 capas de proteccion para mantener WhatsApp conectado 24/7:
Cuando WhatsApp se desconecta, el bridge (bridge.cjs) intenta reconectar automaticamente despues de 5 segundos:
waClient.on("disconnected") → espera 5s → waClient.initialize()Si la inicializacion falla (comun en Raspberry Pi cuando Chromium tarda en cargar), reintenta hasta 5 veces con delays incrementales (10s, 20s, 30s...):
startWhatsApp(attempt) → falla → espera attempt*10s → reintentaSi falla 5 veces, el proceso termina con exit(1) para que systemd lo reinicie.
El MCP server (index.js) ejecuta un health check cada 60 segundos contra la API del bridge. Si detecta que el bridge no responde o reporta desconexion, ejecuta:
sudo systemctl restart whatsapp-bridge.serviceEl bridge corre como servicio systemd. Ejemplo de unit file:
[Unit]
Description=WhatsApp Bridge
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node /ruta/a/bridge.cjs
Restart=always
RestartSec=10
User=tu-usuario
[Install]
WantedBy=multi-user.targetCon Restart=always, systemd reinicia el servicio si crashea, complementando las 3 capas internas.
El bot mantiene contexto entre sesiones usando un sistema de resumenes diarios embebido en el system prompt.
El archivo system-prompt.md contiene marcadores especiales:
<!-- DAILY_SUMMARY_START -->
## Resumen del dia (auto-generado)
- Tareas completadas hoy
- Decisiones importantes tomadas
- Contexto relevante para la proxima sesion
<!-- DAILY_SUMMARY_END -->El agente actualiza automaticamente el contenido entre estos marcadores al final del dia (o cuando acumula contexto relevante). Esto permite que:
Cada nueva sesion de Claude arranca con contexto — el system prompt incluye el resumen, asi Claude sabe que paso ayer sin necesidad de leer todo el historial
No gasta tokens extra — es parte del system prompt que ya se envia, no una consulta adicional
Se auto-limpia — cada dia el resumen se reemplaza con lo nuevo, no crece indefinidamente
El script daily-cleanup.sh corre a las 4am via cron y complementa este sistema:
0 4 * * * /ruta/a/daily-cleanup.shLanza sub-agentes en paralelo para:
Agente | Funcion |
Memory cleanup | Deduplica y limpia memorias de Engram |
System health | Verifica servicios, disco, RAM, errores I/O |
Activity analysis | Analiza mensajes del dia, errores recurrentes, patrones |
Los hallazgos se usan para auto-corregir problemas y alimentar el resumen del dia siguiente.
Si copias system-prompt.example.md, agrega al final:
<!-- DAILY_SUMMARY_START -->
<!-- DAILY_SUMMARY_END -->El bot llenara esta seccion automaticamente.
Primera carga tarda ~90 segundos (normal)
Usa ~300MB RAM estabilizado
Si da "Requesting main frame too early", el retry automatico lo maneja
Minimo 2GB RAM libre recomendado
bridge.cjs # Servicio principal (systemd) — WhatsApp + Claude CLI
index.js # MCP server para Claude Code (liviano, HTTP al bridge)
index.cjs # MCP server legacy (Baileys, referencia)
config.json # Tu configuracion (no commitear)
system-prompt.md # Contexto para el bot (no commitear)
daily-cleanup.sh # Orquestador diario (cron 4am)
cron-f1-check.sh # Ejemplo: notificar cuando descarga F1 termina
emby-guard.sh # Pausa torrents cuando Emby transmite
calendar-notify.py # Notificaciones de Google Calendar por WhatsApp
notify.sh # Enviar mensajes desde bash
examples/
cron-download-check.sh # Ejemplo de cron generico
transcribe.sh # Ejemplo de transcripcion con whisperMIT
This server cannot be deployed
Share context and questions between Claude instances — VS Code, claude.ai web, and mobile.
Drive your real WhatsApp inbox from Claude — send, reply, label, assign, and triage via TimelinesAI.
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
