whatsapp-mcp es un servidor de solo lectura que permite a los agentes de inteligencia artificial buscar y leer los mensajes de WhatsApp de un usuario específico. La herramienta funciona como un dispositivo vinculado, similar a WhatsApp Web, pero está diseñado para ser compatible con cualquier cliente MCP, como Claude Code o Claude Desktop. Su arquitectura se basa en Cloudflare Workers y utiliza una base de datos SQLite alojada en un Durable Object, garantizando que los datos permanezcan en el dispositivo del usuario y no se transmitan a terceros.
El funcionamiento es asíncrono: el servidor se conecta a WhatsApp solo cuando el agente solicita información o una vez al día para recopilar mensajes en cola, sin mantener una conexión activa constante. Esto evita que el teléfono reciba notificaciones adicionales. El proyecto requiere una cuenta de Cloudflare en el plan Paid, Node 20 o superior, y un teléfono móvil para el emparejamiento inicial mediante código QR.
Aunque el proyecto es de código abierto y técnicamente funcional, opera fuera de los términos de servicio oficiales de WhatsApp, ya que utiliza la librería Baileys para acceder a la API no oficial. El autor advierte que, aunque el riesgo práctico es bajo para un dispositivo vinculado de solo lectura, no debe usarse para enviar mensajes ni para fines comerciales. La herramienta soporta búsquedas de texto completo, listas de chats y sincronización de mensajes, pero no transcribe medios ni permite la edición de datos. Cada despliegue está diseñado para un único usuario, manteniendo el historial completo y el acceso en vivo al cuenta.