Automação do Cal.com via Rube MCP

Automatize operações de agendamento do Cal.com através do toolkit Cal do Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Cal.com via RUBE_MANAGE_CONNECTIONS com o toolkit cal
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit cal
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do Cal.com
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Gerenciar Agendamentos

Quando usar: O usuário deseja listar, criar ou revisar agendamentos

Sequência de ferramentas:

1. CAL_FETCH_ALL_BOOKINGS - Listar todos os agendamentos com filtros [Obrigatório]
2. CAL_POST_NEW_BOOKING_REQUEST - Criar um novo agendamento [Opcional]

Parâmetros chave para listagem:

• status: Filtrar por status do agendamento ('upcoming', 'recurring', 'past', 'cancelled', 'unconfirmed')
• afterStart: Filtrar agendamentos após esta data (ISO 8601)
• beforeEnd: Filtrar agendamentos antes desta data (ISO 8601)

Parâmetros chave para criação:

• eventTypeId: ID do tipo de evento para o agendamento
• start: Hora de início do agendamento (ISO 8601)
• end: Hora de término do agendamento (ISO 8601)
• name: Nome do participante
• email: E-mail do participante
• timeZone: Fuso horário do participante (formato IANA)
• language: Código do idioma do participante
• metadata: Objeto de metadados adicionais

Armadilhas:

• Filtros de data usam formato ISO 8601 com fuso horário (ex: '2024-01-15T09:00:00Z')
• eventTypeId deve referenciar um tipo de evento válido e ativo
• A criação de agendamentos requer a correspondência de um slot disponível; verifique a disponibilidade primeiro
• O fuso horário deve ser uma string de fuso horário IANA válida (ex: 'America/New_York')
• Os valores do filtro de status são strings específicas; valores inválidos retornam resultados vazios

2. Verificar Disponibilidade

Quando usar: O usuário deseja encontrar horários livres/ocupados ou slots de agendamento disponíveis

Sequência de ferramentas:

1. CAL_RETRIEVE_CALENDAR_BUSY_TIMES - Obter blocos de tempo ocupado [Obrigatório]
2. CAL_GET_AVAILABLE_SLOTS_INFO - Obter slots disponíveis específicos [Obrigatório]

Parâmetros chave:

• dateFrom: Data de início para verificação de disponibilidade (AAAA-MM-DD)
• dateTo: Data de término para verificação de disponibilidade (AAAA-MM-DD)
• eventTypeId: Tipo de evento para verificar slots
• timeZone: Fuso horário para a resposta de disponibilidade
• loggedInUsersTz: Fuso horário do usuário solicitante

Armadilhas:

• Horários ocupados mostram quando o usuário NÃO está disponível
• Slots disponíveis são específicos para a duração e configuração de um tipo de evento
• O intervalo de datas deve ser razoável (não meses de antecedência) para obter resultados precisos
• O fuso horário afeta como os slots são exibidos; sempre especifique explicitamente
• A disponibilidade reflete integrações de calendário (Google Agenda, Outlook, etc.)

3. Configurar Webhooks

Quando usar: O usuário deseja configurar ou gerenciar notificações de webhook para eventos de agendamento

Sequência de ferramentas:

1. CAL_RETRIEVE_WEBHOOKS_LIST - Listar webhooks existentes [Obrigatório]
2. CAL_GET_WEBHOOK_BY_ID - Obter detalhes de webhook específico [Opcional]
3. CAL_UPDATE_WEBHOOK_BY_ID - Atualizar configuração de webhook [Opcional]
4. CAL_DELETE_WEBHOOK_BY_ID - Remover um webhook [Opcional]

Parâmetros chave:

• id: ID do webhook para operações GET/UPDATE/DELETE
• subscriberUrl: URL do endpoint do webhook
• eventTriggers: Array de tipos de evento para acionar
• active: Se o webhook está ativo
• secret: Segredo de assinatura do webhook

Armadilhas:

• URLs de webhook devem ser endpoints HTTPS acessíveis publicamente
• Gatilhos de evento incluem: 'BOOKING_CREATED', 'BOOKING_RESCHEDULED', 'BOOKING_CANCELLED', etc.
• Webhooks inativos não disparam; alterne active para habilitar/desabilitar
• Segredos de webhook são usados para verificação de assinatura de payload

4. Gerenciar Equipes

Quando usar: O usuário deseja criar, visualizar ou gerenciar equipes e tipos de eventos de equipe

Sequência de ferramentas:

1. CAL_GET_TEAMS_LIST - Listar todas as equipes [Obrigatório]
2. CAL_GET_TEAM_INFORMATION_BY_TEAM_ID - Obter detalhes de equipe específica [Opcional]
3. CAL_CREATE_TEAM_IN_ORGANIZATION - Criar uma nova equipe [Opcional]
4. CAL_RETRIEVE_TEAM_EVENT_TYPES - Listar tipos de evento para uma equipe [Opcional]

Parâmetros chave:

• teamId: Identificador da equipe
• name: Nome da equipe (para criação)
• slug: Identificador de equipe amigável para URL

Armadilhas:

…