WhatsApp MCP: tu agente de IA lee tus chats en Cloudflare

Un servidor MCP que le da a tu agente de IA acceso de lectura a WhatsApp

El repositorio finereli/whatsapp-mcp publicó un servidor que corre dentro de tu propia cuenta de Cloudflare y permite que cualquier cliente compatible con MCP —Claude Code, Claude Desktop o cualquier otro— busque y lea tus chats de WhatsApp. No envía mensajes: solo lee. Y tus conversaciones no salen de tu infraestructura.

Para un founder que vive dentro de WhatsApp con clientes, proveedores y equipo, esto abre una puerta concreta: dejar de buscar manualmente en el teléfono y preguntarle a un agente "¿qué me dijo el proveedor sobre el pedido?" o "resume lo que me perdí en el grupo del equipo esta semana".

¿Cómo funciona sin que tus mensajes salgan de tu cuenta?

La arquitectura es la parte más interesante del proyecto. El servidor no vive en la nube de un tercero: se despliega en tu cuenta de Cloudflare Workers y guarda todo en una base SQLite dentro de un Durable Object.

• Vinculas tu teléfono una sola vez, igual que cuando conectas WhatsApp Web. El teléfono sigue siendo la fuente de verdad.
• El servidor no mantiene la conexión abierta. Se conecta cuando tu agente pide algo y una vez al día (un cron a las 04:00 UTC), recoge lo que WhatsApp dejó en cola, lo escribe en su base y se desconecta.
• Tu teléfono sigue funcionando normal y sigue recibiendo notificaciones.

Ese diseño de "conectar, recoger y colgar" es deliberado: reduce la superficie de exposición y evita el problema clásico de los bots que se quedan online y silencian las notificaciones del teléfono.

¿Qué puede hacer tu agente y qué no?

El servidor expone ocho herramientas MCP. Las centrales son listchats, getmessages y searchmessages, que permiten búsqueda de texto completo sobre todo el historial o dentro de un chat específico. También hay unnamedchats, setcontactnames, syncnow, linkstatus y relink.

Los límites están tan definidos como las capacidades:

• No puede enviar nada. Es de solo lectura por diseño, y el autor es explícito: "piensa bien antes de agregar envío".
• No descarga multimedia. Fotos, notas de voz y documentos aparecen como etiquetas del tipo [image] o [voice note 12s], con el pie de foto si lo había. Nada se transcribe.
• Es para una sola persona. Un despliegue equivale a una cuenta de WhatsApp y un dueño. Cada quien debe correr el suyo.
• Los nombres de contacto son parciales. WhatsApp no le entrega a un dispositivo vinculado todos los nombres, así que muchos chats aparecen como números. El agente puede resolverlos consultando tus contactos y guardándolos con setcontactnames.

La diferencia con el MCP oficial de WhatsApp Business

Aquí está el contraste que importa para cualquier founder que esté evaluando integrar WhatsApp con IA. En septiembre de 2026, Meta anunció el WhatsApp Business Tools MCP, un servidor oficial que conecta agentes como Claude, Cursor, Codex o ChatGPT a la WhatsApp Business Platform para automatizar tareas de configuración: crear la cuenta de negocio, verificar el número, registrar el acceso a la Cloud API y revisar los términos de servicio, según reportó TechCrunch.

Son dos cosas distintas y conviene no confundirlas:

• El MCP oficial de Meta es para empresas que atienden clientes a través de la API de negocio. Es un camino sancionado, con verificación y reglas.
• Este proyecto es para leer tu WhatsApp personal. No existe API oficial para eso, así que usa el mismo protocolo de WhatsApp Web a través de la librería de código abierto Baileys.

Esa diferencia tiene consecuencias legales y de riesgo que el propio autor reconoce sin adornos.

El riesgo que tienes que evaluar antes de instalarlo

El repositorio lo dice con claridad: usar Baileys va contra los términos de servicio de WhatsApp. Para un dispositivo vinculado que solo lee, el riesgo práctico es bajo, pero no es cero. La recomendación del autor es usarlo en tu propia cuenta y nunca para enviar mensajes.

Hay otros detalles operativos que conviene saber antes de empezar:

• Necesitas el plan Workers Paid de Cloudflare (unos pocos dólares al mes), Node 20 o superior y tu teléfono.
• El plan pago es necesario porque la importación inicial de un historial grande consume mucha CPU y el límite gratuito de Workers no alcanza. El autor no probó el plan gratuito.
• El historial se importa una sola vez por vinculación. Si la primera importación falla a mitad de camino, esa historia se pierde hasta que vuelvas a vincular.
• El proyecto está bajo licencia MIT y solo se probó contra una cuenta real.

¿Qué significa esto para tu startup?

El valor de este proyecto no está en la herramienta en sí, sino en lo que demuestra sobre el estado del ecosistema MCP. Según Forkast, el protocolo ya acumula más de 500 millones de descargas mensuales de SDK, y el patrón de diseño que usa este servidor —herramientas de solo lectura, permisos por usuario, superficie mínima— es exactamente el que recomiendan los especialistas.

En una guía práctica sobre MCP publicada por Visual Studio Magazine, el CTO de Xebia, Marcel de Vries, resume la regla: empieza por una capacidad de solo lectura que responda una pregunta que la gente ya hace mucho, y no expongas la herramienta que escribe en tu base de datos o mueve dinero. Este servidor de WhatsApp es un caso de manual de esa filosofía.

Dos acciones concretas que puedes tomar esta semana:

• Audita qué datos tuyos ya son accesibles para un agente. Si usas Claude Code o Cursor a diario, revisa qué conectores y servidores MCP tienes activos. La pregunta no es si quieres darle acceso a tu información, sino qué información ya le diste sin darte cuenta.
• Aplica el patrón de solo lectura a tu propio producto. Si estás construyendo un SaaS, el camino de menor riesgo para exponerlo a agentes es empezar con dos o tres herramientas de consulta, con los permisos del usuario que pregunta y no con una cuenta de servicio compartida. De Vries advierte que exponer cada endpoint de tu API como herramienta produce servidores inútiles: el modelo elige peor entre 200 herramientas que entre 10.

El proyecto también deja una lección de arquitectura para quien construya sobre Cloudflare: usar un Durable Object como almacén y sesión efímera permite correr una integración sensible sin mantener un proceso vivo ni mover los datos fuera de tu cuenta. Es un patrón replicable para cualquier integración con servicios que no ofrecen API oficial.

Fuentes

• finereli/whatsapp-mcp (fuente original)
• Meta now lets AI agents handle the boring parts of WhatsApp Business setup - TechCrunch
• PAP as Third Protocol Stack Fragment - Forkast
• Opening Up Your App to AI Agents: A Practical Guide to MCP with .NET - Visual Studio Magazine