WhatsApp MCP para macOS

Un servidor de Model Context Protocol que conecta a Claude con tu WhatsApp. Lee mensajes, busca contactos, envía respuestas, todo a través de una conversación natural.

Características

• Buscar contactos — Encuentra a cualquier persona por nombre o número de teléfono

• Leer mensajes — Obtén el historial de chat con filtrado por fecha y búsqueda

• Listar chats — Mira las conversaciones recientes con conteo de mensajes no leídos

• Enviar mensajes — Responde directamente a través de Claude (con autenticación QR)

• Mensajes entrantes en tiempo real — Recibe mensajes a medida que llegan

Requisitos

• macOS con la aplicación de escritorio de WhatsApp instalada y con sesión iniciada

• Python 3.10+

• Node.js 18+ (para enviar mensajes)

Instalación

Usando pip

pip install whatsapp-mcp-macos

Desde el código fuente

git clone https://github.com/kalki-kgp/whatsapp-mcp.git
cd whatsapp-mcp
pip install -e .

Conectar a Claude Desktop

1. Abre el archivo de configuración:

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Si no existe, créalo.

2. Añade el servidor MCP de WhatsApp:

   {
     "mcpServers": {
       "whatsapp": {
         "command": "python3",
         "args": ["-m", "whatsapp_mcp"]
       }
     }
   }

3. Reinicia Claude Desktop (Cmd+Q, luego vuelve a abrirlo)

4. Busca el icono de herramientas MCP (🔨) en la entrada de chat — haz clic en él para verificar que "whatsapp" aparece en la lista

5. Empieza a chatear:

   • "Show my recent WhatsApp chats"

   • "Search messages for dinner plans"

Conectar a Cursor

Añade esto a .cursor/mcp.json en tu proyecto:

{
  "mcpServers": {
    "whatsapp": {
      "command": "python3",
      "args": ["-m", "whatsapp_mcp"]
    }
  }
}

Reinicia Cursor y usa las herramientas de WhatsApp en el chat de IA.

Uso

Leer mensajes (funciona inmediatamente)

Solo pregúntale a Claude:

• "Show my recent WhatsApp chats"

• "Search for messages about dinner"

• "What did John say yesterday?"

• "Catch me up on unread messages"

Enviar mensajes (requiere puente)

1. Inicia el puente de WhatsApp:

   cd bridge && npm install && npm start

2. Pídele a Claude que verifique la conexión:

   • "Check WhatsApp status"

3. Si muestra un código QR, abre la URL de datos en un navegador y escanéalo con tu teléfono

4. Una vez conectado, puedes enviar:

   • "Send a message to Mom saying I'll be late"

   • "Reply to John with 'sounds good'"

Herramientas

Cómo funciona

Claude ──MCP──▶ WhatsApp MCP Server
                       │
                       ├──▶ Local SQLite DBs (read messages)
                       │    ~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/
                       │
                       └──▶ WhatsApp Bridge (:3010) ──▶ WhatsApp Web
                            (for sending)

Las operaciones de lectura consultan la base de datos local de WhatsApp directamente: es rápido y funciona sin conexión.

Las operaciones de envío pasan por el puente, que se conecta a WhatsApp Web usando Baileys.

Desarrollo

# Clone
git clone https://github.com/kalki-kgp/whatsapp-mcp.git
cd whatsapp-mcp

# Install in dev mode
pip install -e ".[dev]"

# Run server
python -m whatsapp_mcp

Privacidad

• Todos los datos permanecen locales: los mensajes se leen desde tu propia base de datos de WhatsApp

• No se envían datos a servidores externos (excepto a WhatsApp Web al enviar)

• El servidor MCP se ejecuta localmente en tu máquina

Licencia

MIT