MCP: Calendar
Availability, meetings and transcripts through the MCP. 5 tools.
Tools in this area, generated from the server code. The descriptions come from that code, in Portuguese. To connect, see the XBASE MCP.
cancel-meeting
Cancela uma reunião agendada, pelo ID devolvido por list-meetings ou create-meeting. Confirme com a pessoa antes: o horário deixa de constar na agenda (e o evento some do Google Calendar da agenda do quadro). Passe workspaceId para restringir a reuniões da agenda do quadro daquele workspace; para reuniões da agenda antiga, omita o workspaceId.
| Parameter | Required | Description |
|---|---|---|
meetingId | yes | ID da reunião a cancelar |
workspaceId | no | ID do workspace (opcional): restringe a reuniões da agenda do quadro desse workspace |
create-meeting
Agenda uma reunião. PREFIRA passar boardId (quadro da negociação) e threadId: a reunião vai para a agenda do quadro (definida em Configurações do Quadro) — cria o evento no Google Calendar vinculado com link do Meet e convite ao contato, registra no CRM vinculado à thread e recusa (409) horário ocupado sugerindo alternativas; sem endAt usa a duração da agenda (ex.: 40 min). Antes, chame get-meeting-availability e use o startAt exatamente como veio. Para remarcar, passe replaceMeetingId com o ID da reunião antiga. Sem boardId/calendarId/threadId, usa a agenda antiga do workspace (sem Google/Meet; title e endAt obrigatórios). Se vier erro de agenda (quadro sem agenda, Google desconectado/expirado), chame um humano.
| Parameter | Required | Description |
|---|---|---|
workspaceId | yes | ID do workspace |
title | no | Título da reunião (ex: "Call de alinhamento"). Obrigatório sem boardId/calendarId/threadId; com eles, o padrão é "Reunião com <contato>" |
startAt | yes | Início em ISO 8601 com fuso (ex: 2026-09-01T14:00:00.000Z) — use o startAt devolvido por get-meeting-availability |
endAt | no | Fim em ISO 8601 com fuso, posterior ao início. Obrigatório sem boardId/calendarId/threadId; com eles, o padrão é a duração da agenda |
boardId | no | ID do quadro: usa a agenda do quadro (recomendado) |
calendarId | no | ID da agenda (alternativa a boardId; não envie os dois) |
threadId | no | ID da thread (negociação) para vincular a reunião; sem boardId/calendarId, usa a agenda do quadro da thread |
durationMinutes | no | Duração em minutos (10 a 480), no lugar de endAt — só com boardId/calendarId/threadId |
createMeet | no | Criar link do Google Meet (padrão true na agenda do quadro; ignorado na agenda antiga) |
replaceMeetingId | no | Remarcação: ID da reunião antiga da mesma thread, cancelada depois que a nova é criada |
description | no | Pauta ou observações |
contactId | no | ID do contato do CRM, para vincular a reunião a ele |
attendees | no | E-mails convidados |
get-meeting-availability
Horários LIVRES na agenda de um quadro (use boardId; a agenda é a definida em Configurações do Quadro → Agenda do Quadro) ou de uma agenda específica (calendarId) — informe exatamente um dos dois. Já desconta o Google Calendar vinculado e as reuniões do CRM, respeita a janela da agenda (ex.: seg–qui 14h–17h, horário de Brasília) e a antecedência mínima, e devolve os mais próximos primeiro. Mostre ao contato o rótulo em horário de Brasília (ex.: "seg, 29/09 às 14:00 (BRT)") e passe o startAt EXATAMENTE como veio para create-meeting (com o mesmo boardId). Se vier erro de agenda (quadro sem agenda, Google desconectado ou expirado), repasse a um humano e não invente horários.
| Parameter | Required | Description |
|---|---|---|
workspaceId | yes | ID do workspace (obrigatório) |
boardId | no | ID do quadro (usa a agenda do quadro). Informe boardId OU calendarId. |
calendarId | no | ID da agenda. Informe boardId OU calendarId. |
from | no | A partir de quando buscar, em ISO 8601 (padrão: agora) |
days | no | Quantos dias à frente olhar (1 a 60, padrão 14) |
durationMinutes | no | Duração desejada em minutos (10 a 480; padrão: a duração do horário da agenda) |
limit | no | — |
get-meeting-transcript
Lê o resumo ou a transcrição do Tactiq vinculada a uma reunião da Agenda (as reuniões com "com transcrição" em list-meetings). part: "summary" (padrão) traz o resumo; part: "transcript" traz a transcrição em trechos (offset/limit em caracteres, padrão 40.000). Só leitura; exige token de acesso MCP (xmcp_).
| Parameter | Required | Description |
|---|---|---|
meetingId | yes | ID da reunião |
part | no | "summary" (padrão) ou "transcript" |
offset | no | Só em "transcript": caractere inicial (padrão 0) |
limit | no | Só em "transcript": caracteres por trecho (1.000–100.000, padrão 40.000) |
list-meetings
Lista as reuniões agendadas num período. Com boardId (ou calendarId), lista as reuniões da agenda do quadro com ID, horário (Brasília), thread, contato, link do Meet e status (e "com transcrição" quando há transcrição do Tactiq, lida com get-meeting-transcript) — use para achar o ID antes de remarcar/cancelar. Sem eles, lista a agenda antiga do workspace. Para saber horários LIVRES, use get-meeting-availability.
| Parameter | Required | Description |
|---|---|---|
workspaceId | yes | ID do workspace |
boardId | no | ID do quadro: lista as reuniões da agenda do quadro |
calendarId | no | ID da agenda (alternativa a boardId; não envie os dois) |
from | no | Início do período em ISO 8601 (padrão: 90 dias atrás; na agenda do quadro, 7 dias atrás) |
to | no | Fim do período em ISO 8601 (padrão: 180 dias à frente; na agenda do quadro, 60 dias à frente) |
includeCanceled | no | Incluir reuniões canceladas (só na agenda do quadro; padrão false) |