whatsapp-mcp-server

ULISESRCM/whatsapp-mcp-server

3.2

If you are the rightful owner of whatsapp-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

This document provides a comprehensive guide to setting up and using a Model Context Protocol (MCP) server for integrating WhatsApp with Claude Desktop.

Tools
4
Resources
0
Prompts
0

WhatsApp MCP Server

Servidor MCP para integrar WhatsApp con Claude Desktop.

Instalación

  1. Abre una terminal en esta carpeta y ejecuta:
npm install

  1. Configura Claude Desktop para usar este servidor. Edita el archivo de configuración:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    Agrega esta configuración:

    {
  "mcpServers": {
    "whatsapp": {
      "command": "node",
      "args": ["C:\\Users\\23939710019\\Desktop\\whatsapp-mcp-server\\index.js"]
    }
  }
}

  2. Reinicia Claude Desktop completamente (cierra y vuelve a abrir).

  3. La primera vez que uses el servidor, aparecerá un código QR en los logs. Debes:

    • Abrir WhatsApp en tu teléfono
    • Ir a Configuración > Dispositivos vinculados
    • Escanear el código QR que aparece en la terminal/logs

Uso

Una vez conectado, puedes pedirle a Claude:

  • "Envía un mensaje de WhatsApp a 5491112345678 diciendo 'Hola'"
  • "Muéstrame mis últimos chats de WhatsApp"
  • "Lee los mensajes de mi chat con 5491112345678"
  • "Verifica el estado de WhatsApp"

Notas importantes

  • Los números deben incluir código de país (Argentina: 549)
  • No uses +, espacios ni guiones en los números
  • Ejemplo correcto: 5491112345678
  • La primera conexión requiere escanear código QR
  • Las sesiones quedan guardadas, solo necesitas escanear una vez

Herramientas disponibles

  1. whatsapp_status: Verifica si WhatsApp está conectado
  2. send_whatsapp_message: Envía mensajes
  3. read_whatsapp_chats: Lee lista de chats recientes
  4. read_chat_messages: Lee mensajes de un chat específico