WhatsApp MCP
by lharries
Lee y envía mensajes de WhatsApp desde tu asistente de IA
communication Python Intermedio Auto-hospedable Sin API key
⭐ 5.4k stars 📅 Actualizado: hace 1m
Descripción
Un servidor MCP que conecta tu cuenta personal de WhatsApp a Claude, Cursor y otros asistentes de IA. Usa la biblioteca whatsmeow (Go) para conectar vía la API web multidispositivo de WhatsApp con autenticación por código QR. Los mensajes se almacenan localmente en SQLite con control total del usuario sobre los datos. Soporta buscar contactos, leer mensajes (texto, imágenes, vídeos, documentos, audio), enviar mensajes a individuos y grupos, y descargar archivos multimedia. Incluye conversión automática de formato de audio vía FFmpeg. La arquitectura se divide en un bridge Go para conectividad WhatsApp y un servidor MCP Python para la interfaz con IA.
✅ Ideal para
Usuarios avanzados que quieren asistentes de IA con acceso completo a WhatsApp en su máquina local
⏭️ No recomendado si
Necesitas una integración WhatsApp de producción o empresarial
💡 Casos de uso
- Leer y buscar historial de mensajes de WhatsApp desde asistentes de IA
- Enviar mensajes de WhatsApp mediante comandos en lenguaje natural
- Extraer y analizar datos de conversaciones para resúmenes o insights
- Automatizar respuestas y notificaciones de WhatsApp
👍 Ventajas
- ✓ Integración directa con WhatsApp sin APIs de terceros ni cuentas business
- ✓ Almacenamiento solo local — los mensajes se quedan en tu máquina
- ✓ Soporta todos los tipos de media (texto, imágenes, vídeo, audio, documentos)
- ✓ Gran comunidad (5k+ stars) con desarrollo activo
👎 Desventajas
- ✗ Requiere runtimes de Go y Python más FFmpeg para audio
- ✗ Necesita autenticación por código QR en la primera configuración
- ✗ Advertencia de seguridad: prompt injection podría permitir exfiltración de datos
- ✗ Sin paquete oficial npm/pip — requiere clonar y configurar manualmente
🔧 Herramientas expuestas (12 herramientas)
| Tool | Categoría | Descripción |
|---|---|---|
| search_contacts | contacts | Buscar contactos de WhatsApp por nombre o número |
| send_file | media | Enviar un archivo a un contacto o grupo |
| send_audio_message | media | Enviar un mensaje de audio con conversión de formato |
| download_media | media | Descargar media de un mensaje de WhatsApp |
| list_messages | messaging | Listar mensajes de un chat con paginación |
| list_chats | messaging | Listar todos los chats de WhatsApp |
| get_chat | messaging | Obtener detalles de un chat específico |
| get_direct_chat_by_contact | messaging | Obtener chat directo con un contacto |
| get_contact_chats | messaging | Obtener todos los chats que involucran a un contacto |
| get_last_interaction | messaging | Obtener la última interacción con un contacto |
| get_message_context | messaging | Obtener mensajes alrededor de un mensaje específico |
| send_message | messaging | Enviar un mensaje de texto a un contacto o grupo |
⚡ Instalación
Requisitos previos:
- • python v3.6+
- • go
- • uv
- • ffmpeg
Consulta la documentación de Claude Code para configurar este MCP server.
💡 Consejos y trucos
Ejecuta primero el bridge Go con 'go run main.go' y escanea el código QR antes de iniciar el servidor MCP. FFmpeg es opcional pero necesario para soporte de mensajes de audio.
Info rápida
- Autor
- lharries
- Licencia
- MIT
- Runtime
- Python 3.6+
- Transporte
- —
- Categoría
- communication
- Dificultad
- Intermedio
- Auto-hospedable
- ✅
- Auth
- —
- Docker
- —
- Versión
- 0.0.1
- Actualizado
- 28 feb 2026
Compatibilidad con clientes
- ✅ Claude Code
- ✅ Cursor
- ❓ VS Code Copilot
- ❓ Gemini CLI
- ❓ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Enlaces
Plataformas
🍎 macOS 🐧 Linux 🪟 Windows