Automação do Calendly via Rube MCP

Automatize operações do Calendly, incluindo listagem de eventos, gerenciamento de convidados, criação de links de agendamento, consultas de disponibilidade e administração de organização através do kit de ferramentas Calendly do Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Calendly via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas calendly
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais
• Muitas operações exigem o URI do Calendly do usuário, obtido via CALENDLY_GET_CURRENT_USER

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 kit de ferramentas calendly
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Calendly
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Visualizar Eventos Agendados

Quando usar: O usuário deseja ver seus eventos futuros, passados ou filtrados do Calendly

Sequência de ferramentas:

1. CALENDLY_GET_CURRENT_USER - Obter URI do usuário autenticado e URI da organização [Pré-requisito]
2. CALENDLY_LIST_EVENTS - Listar eventos com escopo por usuário, organização ou grupo [Obrigatório]
3. CALENDLY_GET_EVENT - Obter informações detalhadas para um evento específico por UUID [Opcional]

Parâmetros chave:

• user: URI completo da API do Calendly (por exemplo, https://api.calendly.com/users/{uuid}) - NÃO "me"
• organization: URI completo da organização para consultas com escopo de organização
• status: "active" ou "canceled"
• min_start_time / max_start_time: Timestamps UTC (por exemplo, 2024-01-01T00:00:00.000000Z)
• invitee_email: Filtrar eventos por e-mail do convidado (apenas filtro, não um escopo)
• sort: "start_time:asc" ou "start_time:desc"
• count: Resultados por página (padrão 20)
• page_token: Token de paginação da resposta anterior

Armadilhas:

• Exatamente UM de user, organization ou group deve ser fornecido - omitir ou combinar escopos falha
• O parâmetro user requer o URI completo da API, não "me" - use CALENDLY_GET_CURRENT_USER primeiro
• invitee_email é um filtro, não um escopo; você ainda precisa de um de usuário/organização/grupo
• A paginação usa count + page_token; repita até que page_token esteja ausente para resultados completos
• Direitos de administrador podem ser necessários para consultas com escopo de organização ou grupo

2. Gerenciar Convidados de Eventos

Quando usar: O usuário deseja ver quem está agendado para eventos ou obter detalhes do convidado

Sequência de ferramentas:

1. CALENDLY_LIST_EVENTS - Encontrar o(s) evento(s) alvo [Pré-requisito]
2. CALENDLY_LIST_EVENT_INVITEES - Listar todos os convidados para um evento específico [Obrigatório]
3. CALENDLY_GET_EVENT_INVITEE - Obter informações detalhadas para um único convidado [Opcional]

Parâmetros chave:

• uuid: UUID do evento (para LIST_EVENT_INVITEES)
• event_uuid + invitee_uuid: Ambos necessários para GET_EVENT_INVITEE
• email: Filtrar convidados por endereço de e-mail
• status: "active" ou "canceled"
• sort: "created_at:asc" ou "created_at:desc"
• count: Resultados por página (padrão 20)

Armadilhas:

• O parâmetro uuid para CALENDLY_LIST_EVENT_INVITEES é o UUID do evento, não o UUID do convidado
• Paginar usando page_token até que esteja ausente para listas completas de convidados
• Convidados cancelados são excluídos por padrão; use status: "canceled" para vê-los

3. Criar Links de Agendamento e Verificar Disponibilidade

Quando usar: O usuário deseja gerar um link de reserva ou verificar horários disponíveis

Sequência de ferramentas:

1. CALENDLY_GET_CURRENT_USER - Obter URI do usuário [Pré-requisito]
2. CALENDLY_LIST_USER_S_EVENT_TYPES - Listar tipos de evento disponíveis [Obrigatório]
3. CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES - Verificar horários disponíveis para um tipo de evento [Opcional]
4. CALENDLY_CREATE_SCHEDULING_LINK - Gerar um link de agendamento de uso único [Obrigatório]
5. CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES - Visualizar horários de disponibilidade do usuário [Opcional]

Parâmetros chave:

• owner: URI do tipo de evento (por exemplo, https://api.calendly.com/event_types/{uuid})
• owner_type: "EventType" (padrão)
• max_event_count: Deve ser exatamente 1 para links de uso único
• start_time / end_time: Timestamps UTC para consultas de disponibilidade (intervalo máximo de 7 dias)
• active: Booleano para filtrar tipos de evento ativos/inativos
• user: URI do usuário para listagem de tipos de evento

Armadilhas:

• CALENDLY_CREATE_SCHEDULING_LINK pode retornar 403 se o token não tiver direitos ou o URI do proprietário for inválido

…