Skip to main content
Glama
Sign In
whatsapp-claude-code

whatsapp-claude-code

by snestors
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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

Related MCP server: whatsapp-mcp

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:

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • whatsapp

      lwyxzm
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables pushing WhatsApp messages into a running Claude Code session, allowing users to reply and approve or deny tool requests from their phone.
      MIT

    • WhatsApp Channel

      kohakuz2880
      F
      license
      Not graded
      quality
      A
      maintenance
      Enables driving a Claude Code session directly from WhatsApp, with bidirectional messaging, media and voice-note handling, transcription, allowlist-based access control, per-group personalities, cron tasks, and remote tool-approval via emoji reactions. Connects either as a linked device on a personal number or through the official WhatsApp Cloud API for business DMs, without API keys or Docker.
      -