Whasapo

Whasapo

Servidor MCP de WhatsApp. Envía y lee mensajes de WhatsApp desde cualquier asistente de IA que sea compatible con MCP — Claude desktop, Claude Code, OpenClaw y más.

Instalación

macOS / Linux:

curl -sSL https://raw.githubusercontent.com/toloco/whasapo/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/toloco/whasapo/main/install.ps1 | iex

Esto hará lo siguiente:

1. Descargará el binario más reciente para tu plataforma
2. Configurará la aplicación de escritorio de Claude
3. Te guiará para vincular tu cuenta de WhatsApp (escaneo de código QR)

Después de la instalación, reinicia tu aplicación de IA.

Configuración por aplicación

Claude Desktop

El instalador configura esto automáticamente. Si necesitas hacerlo manualmente, agrega a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "~/.whasapo/whasapo",
      "args": ["serve"]
    }
  }
}

Reinicia Claude Desktop. Las herramientas de WhatsApp estarán disponibles de inmediato.

Claude Code

Agrega el servidor MCP a tu proyecto o configuración global:

claude mcp add whatsapp ~/.whasapo/whasapo serve

O agrégalo a ~/.claude/settings.json:

{
  "mcpServers": {
    "whatsapp": {
      "command": "~/.whasapo/whasapo",
      "args": ["serve"]
    }
  }
}

OpenClaw

En la configuración de OpenClaw, agrega un nuevo servidor MCP:

• Nombre: whatsapp
• Comando: ~/.whasapo/whasapo
• Argumentos: serve

O agrégalo a tu archivo de configuración de OpenClaw:

{
  "mcpServers": {
    "whatsapp": {
      "command": "~/.whasapo/whasapo",
      "args": ["serve"]
    }
  }
}

Cualquier cliente compatible con MCP

Whasapo es un servidor MCP estándar que utiliza transporte stdio. Apunta cualquier cliente MCP a:

command: ~/.whasapo/whasapo
args: serve

¿Qué puedes hacer con él?

Pregúntale a tu asistente de IA cosas como:

• "Muéstrame mis mensajes recientes de WhatsApp"
• "Envía un mensaje de WhatsApp a Juan diciendo que llegaré 10 minutos tarde"
• "¿Qué mensajes recibí en el grupo familiar?"
• "Encuentra mi contacto llamado Sara"
• "Responde al último mensaje de mamá dándole las gracias"
• "Resume lo que me perdí en el chat del grupo de trabajo"

Herramientas disponibles

Herramienta	Descripción
send_message	Envía un mensaje de texto a un contacto o grupo
list_chats	Lista los chats recientes con vista previa del último mensaje
get_messages	Obtiene mensajes, opcionalmente filtrados por chat
search_contacts	Busca contactos por nombre o número de teléfono

Comandos

whasapo pair        Link your WhatsApp account (QR code)
whasapo serve       Start the MCP server (your AI app does this automatically)
whasapo status      Check if everything is working
whasapo update      Update to the latest version
whasapo uninstall   Remove whasapo completely
whasapo version     Print version

Solución de problemas

"Claude no muestra las herramientas de WhatsApp" Reinicia la aplicación después de instalar.

"No se puede abrir porque Apple no puede verificar que no contenga software malicioso" Ejecuta esto y luego intenta de nuevo:

xattr -d com.apple.quarantine ~/.whasapo/whasapo

"Conexión fallida" o "no vinculado" Tu enlace de WhatsApp puede haber caducado. Vuelve a vincular:

whasapo pair

"No se encontraron mensajes" Los mensajes anteriores a la primera instalación no aparecerán. Una vez instalado, los mensajes se almacenan de forma persistente y sobreviven a los reinicios.

Desinstalación

whasapo uninstall

O de forma remota:

curl -sSL https://raw.githubusercontent.com/toloco/whasapo/main/install.sh | bash -s -- --uninstall

Compilar desde el código fuente

Requiere Go 1.23+.

make build          # build for your machine → bin/whasapo
make release        # macOS universal binary → dist/whasapo-VERSION-macos.zip
make release-all    # all platforms → dist/whasapo-VERSION-{macos,linux,windows}.*

Cómo funciona

Whasapo es un servidor MCP que se conecta a WhatsApp utilizando la biblioteca whatsmeow — el mismo protocolo que utilizan las aplicaciones oficiales de WhatsApp.

Tu sesión de WhatsApp se almacena localmente en ~/.whasapo/session.db. Los mensajes se guardan en SQLite para que sobrevivan a los reinicios. No se envía ningún dato a servidores de terceros.