通过 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. 调用 RUBE_MANAGE_CONNECTIONS，指定工具包为 calendly
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（用于 CALENDLY_LIST_EVENT_INVITEES）
• event_uuid + invitee_uuid：二者均为 CALENDLY_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

常见陷阱：

• CALENDLY_CREATE_SCHEDULING_LINK 可能返回 403 错误，原因包括 Token 权限不足或 owner URI 无效
• CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES 要求传入 UTC 时间戳，且时间跨度不得超过 7 天；对更长区间需拆分为多次调用
• 可用时间段查询结果**不支持分页**，所有结果均在单次响应中返回
• 事件类型 URI 必须为完整 API URI（例如 https://api.calendly.com/event_types/...）

4. 取消事件

适用场景：用户希望取消已安排的 Calendly 事件

工具调用顺序：

1. CALENDLY_LIST_EVENTS — 查找待取消的事件 [前提]
2. CALENDLY_GET_EVENT — 在取消前确认事件详情 [前提]
3. CALENDLY_LIST_EVENT_INVITEES — 查看受影响的受邀人 [可选]
4. CALENDLY_CANCEL_EVENT — 执行事件取消操作 [必需]

关键参数：

• uuid：待取消事件的 UUID
• reason：可选的取消原因（可能随通知一并发送给受邀人）

常见陷阱：

• 取消操作**不可逆**——调用前务必向用户确认
• 取消操作可能触发通知发送至受邀人
• 仅处于 active 状态的事件可被取消；已取消事件将返回错误
• 执行 CALENDLY_CANCEL_EVENT 前，必须获得用户的明确确认

5. 管理组织及邀请

适用场景：用户希望邀请成员加入组织、管理组织设置，或处理组织级邀请

工具调用顺序：

1. CALENDLY_GET_CURRENT_USER — 获取用户及所属组织上下文 [前提]
2. CALENDLY_GET_ORGANIZATION — 获取组织详情 [可选]
3. CALENDLY_LIST_ORGANIZATION_INVITATIONS — 检查现有邀请 [可选]
4. CALENDLY_CREATE_ORGANIZATION_INVITATION — 发送组织邀请 [必需]
5. CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION — 撤回待处理的邀请 [可选]
6. CALENDLY_REMOVE_USER_FROM_ORGANIZATION — 移除组织成员 [可选]

关键参数：

• uuid：组织 UUID
• email：待邀请用户的邮箱地址
• status：按 "pending"、"accepted" 或 "declined" 过滤邀请

常见陷阱：

• 仅组织所有者或管理员可管理邀请与成员移除；其他角色将收到授权错误
• 对同一邮箱地址重复发送处于 active 状态的邀请将被拒绝——请先检查已有邀请
• 组织所有者无法通过 CALENDLY_REMOVE_USER_FROM_ORGANIZATION 移除自身
• 邀请状态包括 pending、accepted、declined 和 revoked，请根据各状态做相应处理

常见模式

ID 解析

Calendly 使用完整的 API URI 作为标识符，而非简单 UUID：

• 当前用户 URI：CALENDLY_GET_CURRENT_USER 返回 resource.uri（例如 https://api.calendly.com/users/{uuid}）
• 组织 URI：位于当前用户响应中的 resource.current_organization
• 事件 UUID：从事件 URI 或列表响应中提取
• 事件类型 URI：来自 CALENDLY_LIST_USER_S_EVENT_TYPES 的响应

重要提示：切勿在列表/过滤端点中将 "me" 用作 user 参数。务必先解析为完整 URI。

分页

大多数 Calendly 列表端点采用基于 token 的分页机制：

• 通过 count 设置每页大小（默认为 20）
• 持续读取 pagination.next_page_token 中的 page_token，直至其不存在为止
• 排序格式为 field:direction（例如 start_time:asc、created_at:desc）

时间处理

• 所有时间戳必须为 UTC 格式：yyyy-MM-ddTHH:mm:ss.ffffffZ
• 使用 min_start_time / max_start_time 对事件进行日期范围过滤
• 可用时间段查询的最大时间跨度为 7 天；如需更长时间段，请拆分为多次调用

已知陷阱

URI 格式

• 所有实体引用均需使用完整 Calendly API URI（例如 https://api.calendly.com/users/{uuid}）
• 当接口要求 URI 时，切勿传递裸 UUID；也切勿向列表端点传入 "me"
• 当工具要求 UUID 参数（例如 CALENDLY_GET_EVENT）时，请从 URI 中提取 UUID

作用域要求

• CALENDLY_LIST_EVENTS 必须且只能指定一个作用域（user、organization 或 group），不可多选或不选
• 组织或群组级查询可能需要管理员权限
• Token 的作用域决定了可用的操作集；403 错误表示权限不足

数据关系

• 事件关联受邀人（即已预约的参会者）
• 事件类型定义预约页面（含持续时间、可用性规则等）
• 组织包含用户和群组
• 预约链接绑定至事件类型，而非直接绑定至具体事件

速率限制

• Calendly API 存在速率限制；请避免对大数据集执行密集循环调用
• 请合理分页，并在批量操作中加入适当延迟

快速参考