TimelinesAI WhatsApp

Conecta tu bandeja de entrada de WhatsApp de TimelinesAI con Claude. Lista chats, lee el historial, envía mensajes, reacciona, etiqueta, asigna compañeros de equipo — todo como tú, en producción.

GitHubPrueba este MCPPatrocinado

Documentación

WhatsApp MCP de TimelinesAI

Servidor MCP completo: cada acción del espacio de trabajo expuesta a tu asistente de IA.

Controla tu bandeja de entrada de WhatsApp de TimelinesAI desde Claude, Cursor, Claude Code o cualquier cliente compatible con MCP. Lista chats, lee historial, envía mensajes, reacciona, etiqueta, asigna compañeros, consulta cuotas: las 18 herramientas, todas como tú, con la misma cuota que usa la interfaz de TimelinesAI.

¿Qué es esto?

El servidor MCP de TimelinesAI es un control remoto para tu bandeja de entrada real de WhatsApp dentro de TimelinesAI. Conéctate una vez mediante OAuth y tu asistente de IA obtiene 18 herramientas que abarcan descubrimiento de chats, mensajería, triaje (etiquetas + asignaciones) e introspección del espacio de trabajo.

Sin sandbox. Las escrituras son reales y visibles para tus contactos. Los destinatarios no pueden distinguir si un mensaje proviene de la interfaz o de un asistente de IA: todo es simplemente tú.

Requisitos

Una cuenta de producción de TimelinesAI con al menos una cuenta de WhatsApp conectada en tu espacio de trabajo. Sin una cuenta de WhatsApp conectada, la mayoría de las herramientas devolverán resultados vacíos o errores: el MCP es un control remoto para tu bandeja real, no un sandbox.
Node.js 18+ localmente (Cursor / Claude Desktop / Claude Code usan npx para lanzar el proxy mcp-remote).

¿Aún no tienes una cuenta de TimelinesAI? Regístrate gratis →

Configuración rápida (~1 min)

Claude Code (CLI)

claude mcp add timelinesai -- npx -y mcp-remote@latest https://mcp.services.timelines.ai/mcp --host 127.0.0.1

Reinicia Claude Code. Se abrirá una pestaña del navegador en el primer uso: inicia sesión con tu cuenta de TimelinesAI para autorizar. Listo.

Claude Code (plugin)

¿Prefieres una instalación en un solo paso mediante el marketplace de plugins de TimelinesAI?

/plugin marketplace add InitechSoftware/whatsapp-mcp-by-timelinesai
/plugin install timelinesai-whatsapp@timelinesai

Esto conecta automáticamente el servidor MCP, sin configuración manual. Se abre una pestaña del navegador en el primer uso para OAuth. Actualiza más tarde con /plugin marketplace update timelinesai.

Cursor

Edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "timelinesai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.services.timelines.ai/mcp",
        "--host", "127.0.0.1"
      ]
    }
  }
}

Reinicia Cursor.

Claude Desktop

Abre Configuración → Desarrollador → Editar configuración y añade:

{
  "mcpServers": {
    "timelinesai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.services.timelines.ai/mcp",
        "--host", "127.0.0.1"
      ]
    }
  }
}

Cierra por completo Claude Desktop (no solo la ventana) y vuelve a abrirlo. Se abrirá una pestaña del navegador para OAuth en el primer uso.

Consulta examples/ para ver fragmentos de configuración listos para copiar según el cliente.

Primera prueba

Después de reiniciar tu cliente, pregúntale:

"¿Qué herramientas expone el servidor MCP de timelinesai? Agrúpalas por propósito y dame un ejemplo de prompt por grupo."

Eso te dará un recorrido personalizado de lo disponible sin leer documentación.

Catálogo de herramientas (18 herramientas)

Metadatos del espacio de trabajo — 3 herramientas

Introspección de solo lectura. Económicas de llamar.

Herramienta	Propósito
`workspace_quotas`	Plan actual, asientos, cuotas de mensajería y llamadas a la API, período de facturación
`workspace_whatsapp_accounts`	Cuentas de WhatsApp conectadas (id, teléfono, propietario, estado)
`workspace_team`	Compañeros, roles, estado de invitación, vinculaciones de cuentas

Descubrimiento e inspección de chats — 5 herramientas

Explora y lee. Sin escrituras.

Herramienta	Propósito
`list_chats`	Filtra chats por estado, etiquetas, asignado, grupo/directo, teléfono, nombre, fechas, cuenta de WhatsApp — paginado 50/página
`chat_details`	Metadatos completos de un solo chat
`chat_history`	Ventana de contexto de conversación alrededor de un mensaje específico
`get_chat_messages`	Recorre los mensajes de un chat
`message_details`	Inspecciona un solo mensaje

Escrituras de mensajería — 4 herramientas

Consumen cuota. Mismo presupuesto mensual de mensajería que la interfaz de TimelinesAI.

Herramienta	Propósito
`chat_send_message`	Envía un mensaje (texto, adjunto o respuesta) en un chat existente
`whatsapp_account_send_message`	Envía un mensaje a cualquier teléfono mediante una cuenta de WhatsApp específica (crea chat si no existe — envío en frío)
`message_reply`	Respuesta en hilo a un mensaje específico
`message_react`	Establece o elimina una reacción emoji en un mensaje

Mutaciones de chat — 6 herramientas

Operaciones de estado y triaje en chats. Operaciones de etiqueta y asignación idempotentes.

Herramienta	Propósito
`chat_open`	Reabre un chat cerrado
`chat_close`	Cierra un chat
`chat_assign`	Asigna un chat a un compañero por correo electrónico (usa `workspace_team` para descubrir correos)
`chat_unassign`	Desasigna al compañero responsable actual
`chat_set_label`	Añade una etiqueta a un chat
`chat_remove_label`	Elimina una etiqueta de un chat

→ Esquemas completos y ejemplos de prompts: docs/tools.md

Cómo funciona la autenticación

El servidor usa OAuth mediante el proxy mcp-remote. En la primera conexión, tu navegador se abre a mcp.services.timelines.ai: inicia sesión en tu cuenta de TimelinesAI para autorizar. El token se guarda en caché localmente mediante mcp-remote; las sesiones posteriores se reconectan sin solicitar nada.

En máquinas que ya tienen una sesión activa de TimelinesAI (por ejemplo, si has iniciado sesión en TimelinesAI en tu navegador predeterminado, o si ya autorizaste el MCP mediante la integración de Claude.ai), la autorización puede completarse silenciosamente sin aviso del navegador.

Cada acción se ejecuta como tú: los permisos de tu rol en TimelinesAI se aplican a las llamadas MCP exactamente igual que a las acciones de la interfaz.

Seguridad y comportamiento en producción

⚠️ Este servidor MCP controla una bandeja de entrada real de WhatsApp. Lee esta sección antes de enviar escrituras.

Los mensajes enviados mediante MCP son indistinguibles de los enviados en la interfaz. Los destinatarios no pueden notarlo.
Las escrituras son reales e inmediatas. No hay deshacer. Confirma antes de acciones masivas.
La cuota es compartida con el uso de la interfaz: los mensajes MCP consumen el mismo presupuesto mensual de mensajería. Llama a workspace_quotas para ver el margen disponible.
No hay modo sandbox. Practica primero con tu propio número si no estás seguro.
Sin una cuenta de WhatsApp conectada, la mayoría de las herramientas devuelven resultados vacíos o errores. Conecta una cuenta de WhatsApp en TimelinesAI primero.

Comienza

Regístrate en TimelinesAI →
Conecta una cuenta de WhatsApp en el panel de TimelinesAI.
Elige tu cliente arriba (Claude Code, Cursor o Claude Desktop) y pega la configuración.
Reinicia, autoriza, pregunta a tu asistente qué puede hacer.

Enlaces

TimelinesAI — timelines.ai
Registro — app.timelines.ai/register
Endpoint del servidor MCP — https://mcp.services.timelines.ai/mcp
Model Context Protocol — modelcontextprotocol.io
Proxy mcp-remote — npm
Problemas / comentarios — abre un issue en este repositorio