whatsapp-claude-code

MCP WhatsApp para Claude Code

Bot de WhatsApp que responde con Claude. Funciona como servicio 24/7 — no necesitas tener Claude Code abierto.

Como funciona

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 WhatsApp

Instalacion

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 WhatsApp

Eso es todo. Claude Code hace el resto.

Requisitos

• Node.js 18+
• Chromium o Chrome
• Claude Code CLI instalado y autenticado

Que puede hacer

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: ``bash ./notify.sh 584121234567 "La descarga termino!" ``

Configuracion

config.json:

| Campo | Default | Que es | |---|---|---| | authorized_numbers | [] | Numeros que pueden hablarle (vacio = todos) | | auto_respond | true | Responder automaticamente con Claude | | typing_timeout | 120 | Segundos maximo mostrando "escribiendo..." | | qr_port | 3456 | Puerto web para escanear QR | | api_port | 3457 | Puerto API interno | | chromium_path | /usr/bin/chromium | 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.

Arquitectura

                              +-----------------------+
                              |     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:

1. Llega mensaje de WhatsApp al Bridge
2. Bridge muestra "escribiendo..." y llama a claude -p --resume <session>
3. Claude procesa con el system prompt y herramientas MCP disponibles
4. La respuesta se envia de vuelta por WhatsApp
5. La sesion persiste entre mensajes (contexto continuo)

WA Watchdog (auto-reconexion)

El sistema tiene 3 capas de proteccion para mantener WhatsApp conectado 24/7:

Capa 1: Auto-reconnect en el bridge

Cuando WhatsApp se desconecta, el bridge (bridge.cjs) intenta reconectar automaticamente despues de 5 segundos:

waClient.on("disconnected") → espera 5s → waClient.initialize()

Capa 2: Retry en el arranque

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 → reintenta

Si falla 5 veces, el proceso termina con exit(1) para que systemd lo reinicie.

Capa 3: Health monitor en el MCP server

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.service

Configuracion

El 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.target

Con Restart=always, systemd reinicia el servicio si crashea, complementando las 3 capas internas.

Daily Summary System

El bot mantiene contexto entre sesiones usando un sistema de resumenes diarios embebido en el system prompt.

Como funciona

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:

1. 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
2. No gasta tokens extra — es parte del system prompt que ya se envia, no una consulta adicional
3. Se auto-limpia — cada dia el resumen se reemplaza con lo nuevo, no crece indefinidamente

Daily orchestrator (cron)

El script daily-cleanup.sh corre a las 4am via cron y complementa este sistema:

0 4 * * * /ruta/a/daily-cleanup.sh

Lanza 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.

Agregar los marcadores a tu system prompt

Si copias system-prompt.example.md, agrega al final:

<!-- DAILY_SUMMARY_START -->
<!-- DAILY_SUMMARY_END -->

El bot llenara esta seccion automaticamente.

Notas Raspberry Pi

• 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

Estructura

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 whisper

Licencia

MIT