WhatsApp MCP

npx add-mcp 'https://server.wa-mcp.com/mcp'

Documentación de WhatsApp MCP

WhatsApp MCP conecta tu asistente de IA (Claude, ChatGPT, Cursor o cualquier cliente que admita el Model Context Protocol) con el número de WhatsApp que ya usas. Tu asistente puede leer y buscar tus chats, encontrar quién está esperando una respuesta y enviar, programar, editar o reaccionar a mensajes, siempre desde tu propio número y solo cuando se lo pidas.

Se vincula a WhatsApp como un dispositivo vinculado, igual que lo hace WhatsApp Web. No hay ninguna app que instalar, ni un número nuevo, ni la API de Meta Business.

Configuración

Te conectas una vez y luego vinculas tu WhatsApp en el chat.

Opción A: el directorio de conectores de Claude

1. En Claude, abre el directorio de conectores y busca WhatsApp MCP.
2. Haz clic en Conectar. Se abre nuestra página de conexión: comprueba que indica tu app de IA y vuelve a hacer clic en Conectar.
3. De vuelta en Claude, abre un chat nuevo y escribe "Conecta mi WhatsApp" (consulta "Vincula tu WhatsApp" más abajo).

No hay registro ni contraseña: tu número de WhatsApp es tu cuenta, y vincularlo es cómo sabemos que eres tú.

Opción B: una URL de conexión personal (cualquier cliente MCP)

1. Ve a wa-mcp.com, elige tu app de IA y haz clic en Generar mi enlace.
2. Añade el enlace a tu app de IA como conector personalizado (servidor MCP). El sitio muestra los pasos exactos para cada app, y Cómo conectar Claude a WhatsApp explica Claude paso a paso.
3. Abre un chat nuevo y escribe "Conecta mi WhatsApp".

Mantén el enlace en privado: funciona como una contraseña. Puedes usar el mismo enlace en varias apps de IA.

Vincula tu WhatsApp

Cuando le pides a tu asistente que conecte tu WhatsApp, te ofrece dos formas:

• Código QR: tu asistente muestra un código QR (y un enlace a una página con él). En tu teléfono, abre WhatsApp → Ajustes → Dispositivos vinculados → Vincular un dispositivo y escanéalo.
• Código de emparejamiento: dale a tu asistente tu número de teléfono con su código de país. Te devuelve un código de 8 caracteres. En tu teléfono, abre Dispositivos vinculados → Vincular un dispositivo → Vincular con el número de teléfono y escribe el código.

Tras la vinculación, WhatsApp sincroniza tu historial reciente (hasta unos 90 días) con el dispositivo vinculado, lo que puede tardar unos minutos en cuentas grandes.

Planes

• Prueba gratuita: todas las funciones durante 1 hora después de vincular un teléfono por primera vez.
• Plan gratuito: tras la prueba, leer, resumir y buscar chats y enviar mensajes de texto siguen funcionando. Los mensajes de texto terminan con "Enviado vía wa-mcp.com", y no se pueden iniciar conversaciones nuevas (personas que no te han escrito en los últimos 90 días).
• Plan de pago: archivos (fotos, vídeos, notas de voz, documentos), mensajes programados, edición, reaccionar a mensajes y eliminarlos, conversaciones nuevas con protecciones anti-bloqueo, y sin etiqueta.

Pregúntale a tu asistente "¿Qué plan tengo?" para ver tu plan y las opciones de suscripción.

Herramientas

Tu asistente elige las herramientas; tú solo preguntas con palabras normales.

Lectura

Herramienta	Qué hace
get_recent_chats	Tus chats más recientes, con el último mensaje de cada uno.
get_unanswered_chats	Chats donde el último mensaje es de la otra persona, para que veas quién está esperando una respuesta.
read_chat_history	Los mensajes de un chat, persona o grupo.
search_messages	Busca en el texto de tus mensajes, opcionalmente en un chat o de una persona.
search_contacts	Encuentra un contacto o grupo por nombre o número.
download_media	Abre una foto, nota de voz, vídeo, documento o sticker de un mensaje.
get_writing_style	Ejemplos de cómo escribes, para que los borradores escritos para ti suenen como tú.

Escritura

Herramienta	Qué hace
send_message	Envía un texto, o un archivo desde un enlace, a una persona o grupo. Muestra primero un indicador de escritura.
schedule_message	Programa un mensaje para más tarde, una vez o de forma repetida (diaria, semanal, mensual y más).
list_scheduled_messages	Lista los mensajes programados próximos y el historial de los pasados.
cancel_scheduled_message	Cancela un mensaje programado (todas sus repeticiones).
react_to_message	Reacciona a un mensaje con un emoji, o elimina la reacción.
edit_message	Cambia el texto de uno de tus propios mensajes.
delete_message	Elimina uno de tus propios mensajes para todos.
mark_as_read	Marca un chat como leído.

Conexión y cuenta

Herramienta	Qué hace
get_session_status	Indica si tu WhatsApp está vinculado y conectado.
get_pairing_qr	Inicia la vinculación con un código QR.
request_pairing_code	Inicia la vinculación con un código de emparejamiento.
restart_session	Se reconecta a WhatsApp si los mensajes dejan de llegar.
manage_subscription	Muestra tu plan y las opciones de suscripción.
report_feedback	Nos envía un informe de error o una solicitud de función.
unlink_whatsapp	Desvincula tu WhatsApp (tu cuenta se mantiene).
delete_account	Elimina tu cuenta y todos sus datos, tras tu confirmación.

Ejemplos de indicaciones

• "¿Quién está esperando una respuesta mía desde ayer?"
• "Resume de qué habló el grupo de la familia esta semana."
• "Encuentra el mensaje donde Carlos me envió la dirección."
• "Dile a Ana que el pedido se envía el jueves." (tu asistente muestra primero el borrador, salvo que le hayas dado las palabras exactas)
• "Cada lunes a las 9, recuérdale al grupo del equipo que envíen su actualización semanal."

Seguridad

• Tú mantienes el control de lo que se envía. Cuando tu asistente escribe un mensaje por ti, te muestra el borrador antes de enviarlo, salvo que le hayas dado el texto exacto.
• Protecciones anti-bloqueo. Los mensajes a personas que no te han escrito en los últimos 90 días se espacian (como máximo 1 por minuto y 10 personas distintas cada 12 horas), porque eso es lo que hace que los números se marquen como spam. Los chats con personas que te han escrito nunca tienen límite. No hay herramientas de envío masivo.
• Indicador de escritura. Aparece un breve "escribiendo…" antes de cada mensaje, como si lo hubieras escrito tú.

Solución de problemas

• "WhatsApp no está vinculado": se eliminó el dispositivo vinculado (desde tu teléfono o al desvincular). Pídele a tu asistente que vuelva a conectar tu WhatsApp con el mismo número.
• El código de emparejamiento no funciona: los códigos caducan tras poco tiempo. Pide uno nuevo, comprueba que el número incluye el código de país y usa Vincular con el número de teléfono en tu teléfono.
• Los mensajes dejaron de llegar: pídele a tu asistente que reinicie tu conexión de WhatsApp. Si WhatsApp en tu teléfono ha estado sin conexión unos 14 días, WhatsApp cierra la sesión de los dispositivos vinculados: abre WhatsApp en tu teléfono y vuelve a vincular.
• "Esta conexión está registrada permanentemente al número de teléfono…": cada conexión pertenece a un teléfono. Para usar otro número, desvincula y luego elimina el conector y vuelve a añadirlo (o, con una URL personal, genera una nueva).
• El conector dice que no está conectado (usuarios del directorio): elimina WhatsApp MCP de tus conectores y vuelve a conectarlo, luego vincula el mismo teléfono. Tu cuenta y suscripción se conservan.

Privacidad y tus datos

Tus mensajes se almacenan durante 90 días en nuestros servidores para que tu asistente pueda buscarlos, y nunca se usan para publicidad ni para entrenar IA. Lo que tu asistente lee lo gestiona su proveedor según su política. Pídele a tu asistente que desvincule tu WhatsApp o que elimine tu cuenta en cualquier momento; eliminarla borra todo de inmediato. Los detalles completos están en nuestra Política de privacidad y Términos.