---

name: calendly-automation description: "通过 Rube MCP (Composio) 自动化 Calendly 日程安排、事件管理、受邀者跟踪、可用性检查和组织管理。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Calendly 自动化

通过 Composio 的 Calendly 工具包自动化 Calendly 操作，包括事件列表、受邀者管理、日程链接创建、可用性查询和组织管理。

前置条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用工具包 calendly 建立活跃的 Calendly 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema
• 许多操作需要用户的 Calendly URI，通过 CALENDLY_GET_CURRENT_USER 获取

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 有响应以验证 Rube MCP 可用
2. 使用工具包 calendly 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接未处于 ACTIVE 状态，按照返回的认证链接完成 Calendly OAuth
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 列出和查看已安排的事件

使用场景：用户想查看即将到来的、过去的或筛选后的 Calendly 事件

工具调用顺序：

1. CALENDLY_GET_CURRENT_USER - 获取已认证用户 URI 和组织 URI [前置]
2. CALENDLY_LIST_EVENTS - 按用户、组织或群组范围列出事件 [必需]
3. CALENDLY_GET_EVENT - 通过 UUID 获取特定事件的详细信息 [可选]

关键参数：

• user：完整的 Calendly API URI（如 https://api.calendly.com/users/{uuid}）- 不是 "me"
• organization：用于组织范围查询的完整组织 URI
• status："active" 或 "canceled"
• min_start_time / max_start_time：UTC 时间戳（如 2024-01-01T00:00:00.000000Z）
• invitee_email：按受邀者邮箱筛选事件（仅为筛选器，非范围）
• sort："start_time:asc" 或 "start_time:desc"
• count：每页结果数（默认 20）
• page_token：上一响应的分页令牌

注意事项：

• 必须且只能提供 user、organization 或 group 中的一个——省略或组合范围会失败
• user 参数需要完整的 API URI，不是 "me"——先使用 CALENDLY_GET_CURRENT_USER
• invitee_email 是筛选器，不是范围；仍需提供 user/organization/group 之一
• 分页使用 count + page_token；循环直到 page_token 不存在以获取完整结果
• 组织或群组范围查询可能需要管理员权限

2. 管理事件受邀者

使用场景：用户想查看谁预约了事件或获取受邀者详情

工具调用顺序：

1. CALENDLY_LIST_EVENTS - 查找目标事件 [前置]
2. CALENDLY_LIST_EVENT_INVITEES - 列出特定事件的所有受邀者 [必需]
3. CALENDLY_GET_EVENT_INVITEE - 获取单个受邀者的详细信息 [可选]

关键参数：

• uuid：事件 UUID（用于 LIST_EVENT_INVITEES）
• event_uuid + invitee_uuid：GET_EVENT_INVITEE 需要两者
• email：按邮箱地址筛选受邀者
• status："active" 或 "canceled"
• sort："created_at:asc" 或 "created_at:desc"
• count：每页结果数（默认 20）

注意事项：

• CALENDLY_LIST_EVENT_INVITEES 的 uuid 参数是事件 UUID，不是受邀者 UUID
• 使用 page_token 分页直到不存在以获取完整受邀者列表
• 已取消的受邀者默认被排除；使用 status: "canceled" 查看

3. 创建日程链接和检查可用性

使用场景：用户想生成预约链接或检查可用时间段

工具调用顺序：

1. CALENDLY_GET_CURRENT_USER - 获取用户 URI [前置]
2. CALENDLY_LIST_USER_S_EVENT_TYPES - 列出可用事件类型 [必需]
3. CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES - 检查事件类型的可用时间段 [可选]
4. CALENDLY_CREATE_SCHEDULING_LINK - 生成一次性日程链接 [必需]
5. CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES - 查看用户的可用性计划 [可选]

关键参数：

• owner：事件类型 URI（如 https://api.calendly.com/event_types/{uuid}）
• owner_type："EventType"（默认）
• max_event_count：一次性链接必须为 1
• start_time / end_time：可用性查询的 UTC 时间戳（最大 7 天范围）
• active：布尔值，筛选活跃/非活跃事件类型
• user：事件类型列表的用户 URI

注意事项：

• 如果令牌缺少权限或 owner URI 无效，CALENDLY_CREATE_SCHEDULING_LINK 可能返回 403
• CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES 需要 UTC 时间戳且最大 7 天范围；更长的搜索需要拆分
• 可用时间结果不分页——所有结果在一个响应中返回
• 事件类型 URI 必须是完整的 API URI 格式