TimelinesAI WhatsApp

Conecte sua caixa de entrada do WhatsApp do TimelinesAI ao Claude. Liste chats, leia o histórico, envie mensagens, reaja, etiquete, atribua colegas de equipe — tudo como você, em produção.

GitHubExperimente este MCPPatrocinado

Documentação

WhatsApp MCP por TimelinesAI

Servidor MCP completo — todas as ações do espaço de trabalho expostas ao seu assistente de IA.

Controle sua caixa de entrada do WhatsApp do TimelinesAI a partir do Claude, Cursor, Claude Code ou qualquer cliente compatível com MCP. Liste conversas, leia histórico, envie mensagens, reaja, rotule, atribua colegas de equipe, verifique cotas — todas as 18 ferramentas, todas como você, todas na mesma cota que a interface do TimelinesAI usa.

O que é isso?

O servidor MCP do TimelinesAI é um controle remoto para sua caixa de entrada real do WhatsApp dentro do TimelinesAI. Conecte-se uma vez via OAuth, e seu assistente de IA ganha 18 ferramentas em descoberta de conversas, mensagens, triagem (rótulos + atribuições) e introspecção do workspace.

Sem sandbox. As escritas são reais e visíveis para seus contatos. Os destinatários não conseguem distinguir se uma mensagem veio da interface ou de um assistente de IA — é tudo você.

Requisitos

Uma conta de produção do TimelinesAI em funcionamento com pelo menos uma conta do WhatsApp conectada no seu workspace. Sem um WA conectado, a maioria das ferramentas retornará vazio ou erro — o MCP é um controle remoto para sua caixa de entrada real, não um sandbox.
Node.js 18+ localmente (Cursor / Claude Desktop / Claude Code usam npx para iniciar o proxy mcp-remote).

Ainda não tem uma conta TimelinesAI? Cadastre-se grátis →

Configuração 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

Reinicie o Claude Code. Uma aba do navegador abrirá no primeiro uso — faça login com sua conta TimelinesAI para autorizar. Pronto.

Claude Code (plugin)

Prefere instalação em uma etapa via marketplace de plugins do TimelinesAI:

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

Isso conecta automaticamente o servidor MCP — sem configuração manual. Uma aba do navegador abre no primeiro uso para OAuth. Atualize depois com /plugin marketplace update timelinesai.

Cursor

Edite ~/.cursor/mcp.json:

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

Reinicie o Cursor.

Claude Desktop

Abra Configurações → Desenvolvedor → Editar Config e adicione:

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

Saia completamente do Claude Desktop (não apenas feche a janela) e reabra. Uma aba do navegador abrirá para OAuth no primeiro uso.

Veja examples/ para trechos de configuração prontos para copiar por cliente.

Primeira coisa a tentar

Após reiniciar seu cliente, pergunte a ele:

"Quais ferramentas o servidor MCP do timelinesai expõe? Agrupe-as por propósito e dê-me um exemplo de prompt por grupo."

Isso oferece um tour personalizado do que está disponível sem ler nenhuma documentação.

Catálogo de ferramentas (18 ferramentas)

Meta do workspace — 3 ferramentas

Introspecção somente leitura. Barato de chamar.

Ferramenta	Propósito
`workspace_quotas`	Plano atual, assentos, cotas de mensagens + chamadas de API, período de cobrança
`workspace_whatsapp_accounts`	Contas do WhatsApp conectadas (id, telefone, proprietário, status)
`workspace_team`	Colegas de equipe, funções, status de convite, vínculos de conta

Descoberta e inspeção de conversas — 5 ferramentas

Navegue e leia. Sem escritas.

Ferramenta	Propósito
`list_chats`	Filtrar conversas por status, rótulos, responsável, grupo/direto, telefone, nome, datas, conta WA — paginado 50/página
`chat_details`	Metadados completos de uma única conversa
`chat_history`	Janela de contexto da conversa em torno de uma mensagem específica
`get_chat_messages`	Navegar pelas mensagens em uma conversa
`message_details`	Inspecionar uma única mensagem

Escritas de mensagens — 4 ferramentas

Consome cota. Mesmo orçamento mensal de mensagens que a interface do TimelinesAI.

Ferramenta	Propósito
`chat_send_message`	Enviar uma mensagem (texto, anexo ou resposta) em uma conversa existente
`whatsapp_account_send_message`	Enviar uma mensagem para qualquer telefone via uma conta WA específica (cria conversa se não existir — envio a frio)
`message_reply`	Resposta em thread para uma mensagem específica
`message_react`	Definir ou limpar uma reação emoji em uma mensagem

Mutações de conversa — 6 ferramentas

Operações de estado + triagem em conversas. Operações de rótulo e atribuição idempotentes.

Ferramenta	Propósito
`chat_open`	Reabrir uma conversa fechada
`chat_close`	Fechar uma conversa
`chat_assign`	Atribuir conversa a um colega de equipe por e-mail (use `workspace_team` para descobrir e-mails)
`chat_unassign`	Desatribuir o colega de equipe responsável atual
`chat_set_label`	Adicionar um rótulo a uma conversa
`chat_remove_label`	Remover um rótulo de uma conversa

→ Esquemas completos e exemplos de prompts: docs/tools.md

Como funciona a autenticação

O servidor usa OAuth via o proxy mcp-remote. Na primeira conexão, seu navegador abre para mcp.services.timelines.ai — faça login na sua conta TimelinesAI para autorizar. O token é armazenado em cache localmente por mcp-remote; sessões subsequentes reconectam sem solicitação.

Em máquinas que já têm uma sessão ativa do TimelinesAI (por exemplo, você está logado no TimelinesAI no seu navegador padrão, ou já autorizou o MCP via integração do Claude.ai), a autorização pode ser concluída silenciosamente sem prompt do navegador.

Cada ação é executada como você — as permissões do seu papel no TimelinesAI se aplicam às chamadas MCP exatamente como se aplicam às ações da interface.

Segurança + comportamento em produção

⚠️ Este servidor MCP controla uma caixa de entrada real do WhatsApp. Leia esta seção antes de enviar escritas.

Mensagens enviadas via MCP são indistinguíveis de mensagens enviadas na interface. Os destinatários não conseguem distinguir.
As escritas são reais e imediatas. Sem desfazer. Confirme antes de ações em massa.
A cota é compartilhada com o uso da interface — mensagens MCP usam o mesmo orçamento mensal de mensagens. Chame workspace_quotas para ver a margem disponível.
Sem modo sandbox. Pratique no seu próprio número primeiro se não tiver certeza.
Sem uma conta do WhatsApp conectada, a maioria das ferramentas retorna resultados vazios ou erros. Conecte uma conta WA no TimelinesAI primeiro.

Comece agora

Cadastre-se no TimelinesAI →
Conecte uma conta do WhatsApp no painel do TimelinesAI.
Escolha seu cliente acima (Claude Code, Cursor ou Claude Desktop) e cole a configuração.
Reinicie, autorize, pergunte ao seu assistente o que ele pode fazer.