SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场calendly-automation

calendly-automation

办公与效率

查看项目

更新于 10-13 16:15

技能介绍

Calendly Automation 是一个基于 Rube MCP（Composio）的 Calendly 自动化能力，通过 MCP 工具调用在客户端中完成 Calendly 的日程与组织管理操作。

【用途】 该技能用于自动化 Calendly 的运营动作，包括已排期事件的查看与筛选、受邀人跟踪、预约链接创建、可用时间查询，以及组织层面的邀请与成员管理。所有操作均通过 Composio 的 Calendly 工具集完成。

【前置条件】

  • 必须已连接 Rube MCP，即 RUBE_SEARCH_TOOLS 可用。
  • 通过 RUBE_MANAGE_CONNECTIONS 建立状态为 ACTIVE 的 Calendly 连接，toolkit 为 calendly。
  • 每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
  • 许多操作需要用户的 Calendly URI，可先通过 CALENDLY_GET_CURRENT_USER 获取。

【设置方式】

  1. 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API key，添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应，验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS，toolkit 指定为 calendly。
  4. 若连接不是 ACTIVE，按返回的授权链接完成 Calendly OAuth。
  5. 确认连接状态为 ACTIVE 后再运行工作流。

【核心工作流】

  1. 列出与查看已排期事件 适用场景：查看即将到来、已过去或按条件筛选的 Calendly 事件。 工具序列：CALENDLY_GET_CURRENT_USER（获取认证用户与组织 URI，前置）→ CALENDLY_LIST_EVENTS（按用户、组织或 group 作用域列出事件，必需）→ CALENDLY_GET_EVENT（按 UUID 获取事件详情，可选）。 关键参数：user 需传完整 API URI（如 https://api.calendly.com/users/{uuid}），不能传“me”；organization 为组织 URI；status 取 active 或 canceled；min_start_time / max_start_time 为 UTC 时间戳；invitee_email 仅作过滤，不是作用域；sort 支持 start_time:asc / start_time:desc；count 为每页数量（默认 20）；page_token 用于分页。 注意：user、organization、group 三者必须且只能提供一个；invitee_email 是过滤条件仍需配合作用域；需循环使用 page_token 直到其消失以获取完整结果；组织或 group 作用域查询可能需要管理员权限。

  2. 管理事件受邀人 适用场景：查看某事件的预约人及其详情。 工具序列：CALENDLY_LIST_EVENTS（前置）→ CALENDLY_LIST_EVENT_INVITEES（必需）→ CALENDLY_GET_EVENT_INVITEE（可选）。 关键参数：LIST_EVENT_INVITEES 的 uuid 是事件 UUID；GET_EVENT_INVITEE 需 event_uuid 与 invitee_uuid 同时提供；email 可按邮箱过滤；status 取 active 或 canceled；sort 支持 created_at:asc / created_at:desc；count 每页数量（默认 20）。 注意：默认不包含已取消的受邀人，需用 status: "canceled" 查看；用 page_token 分页直到其消失。

  3. 创建预约链接与查询可用时间 适用场景：生成预约链接或查看可预约时间段。 工具序列：CALENDLY_GET_CURRENT_USER（前置）→ CALENDLY_LIST_USER_S_EVENT_TYPES（必需）→ CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES（可选）→ CALENDLY_CREATE_SCHEDULING_LINK（必需）→ CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES（可选）。 关键参数：owner 为事件类型 URI；owner_type 默认 EventType；单次使用链接的 max_event_count 必须为 1；可用时间查询的 start_time / end_time 为 UTC 时间戳且范围最多 7 天；active 用于过滤启用/停用的事件类型；user 为事件类型列表用的用户 URI。 注意：创建预约链接在权限不足或 owner URI 无效时可能返回 403；可用时间查询限 7 天，超长需拆分；可用时间结果不分页，一次返回全部；事件类型 URI 必须为完整 API URI。

  4. 取消事件 适用场景：取消已排期的 Calendly 事件。 工具序列：CALENDLY_LIST_EVENTS（前置）→ CALENDLY_GET_EVENT（确认详情，前置）→ CALENDLY_LIST_EVENT_INVITEES（查看受影响人员，可选）→ CALENDLY_CANCEL_EVENT（必需）。 关键参数：uuid 为待取消事件 UUID；reason 为可选取消原因，可能包含在通知中。 注意：取消不可逆，执行前必须获得用户明确确认；取消可能触发对受邀人的通知；仅可取消处于 active 的事件。

  5. 管理组织与邀请 适用场景：邀请成员、管理组织或处理组织邀请。 工具序列：CALENDLY_GET_CURRENT_USER（前置）→ CALENDLY_GET_ORGANIZATION（可选）→ CALENDLY_LIST_ORGANIZATION_INVITATIONS（可选）→ CALENDLY_CREATE_ORGANIZATION_INVITATION（必需）→ CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION（可选）→ CALENDLY_REMOVE_USER_FROM_ORGANIZATION（可选）。 关键参数：uuid 为组织 UUID；email 为被邀请者邮箱；status 可按 pending / accepted / declined 过滤。 注意：仅组织 owner/admin 可管理邀请与移除；同一邮箱的重复有效邀请会被拒绝，应先检查已有邀请；组织 owner 不能被移除；邀请状态包括 pending、accepted、declined、revoked，需分别处理。

【常见模式与注意事项】

  • ID 解析：Calendly 以完整 API URI 作为标识，而非简单 ID。当前用户 URI 来自 CALENDLY_GET_CURRENT_USER 的 resource.uri；组织 URI 见 resource.current_organization；事件 UUID 从事件 URI 或列表结果中提取；事件类型 URI 来自事件类型列表响应。切勿在列表/过滤端点用“me”作为 user 参数，必须先解析为完整 URI。
  • 分页：多数列表端点使用基于 token 的分页，通过 count 设置页大小（默认 20），沿 page_token 循环直到其消失；排序使用 field:direction 格式。
  • 时间处理：所有时间戳须为 UTC，格式为 yyyy-MM-ddTHH:mm:ss.ffffffZ；事件用 min_start_time / max_start_time 过滤；可用时间查询最大 7 天范围。
  • 作用域：CALENDLY_LIST_EVENTS 必须且仅提供一个作用域（user、organization 或 group）；组织/组查询可能需管理员权限；403 表示权限不足。
  • 数据关系：事件包含受邀人；事件类型定义预约页（时长、可用规则）；组织包含用户与组；预约链接绑定事件类型而非直接绑定事件。
  • 速率限制：Calendly API 存在速率限制，应避免大数据集下的紧密循环，合理分页并在批量操作间加入延迟。

【快速参考】 获取当前用户 CALENDLY_GET_CURRENT_USER（无参数）；按 UUID 获取用户 CALENDLY_GET_USER（uuid）；列出事件 CALENDLY_LIST_EVENTS（user、status、min_start_time）；获取事件详情 CALENDLY_GET_EVENT（uuid）；取消事件 CALENDLY_CANCEL_EVENT（uuid、reason）；列出受邀人 CALENDLY_LIST_EVENT_INVITEES（uuid、status、email）；获取受邀人 CALENDLY_GET_EVENT_INVITEE（event_uuid、invitee_uuid）；列出事件类型 CALENDLY_LIST_USER_S_EVENT_TYPES（user、active）；获取事件类型 CALENDLY_GET_EVENT_TYPE（uuid）；检查可用性 CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES（事件类型 URI、start_time、end_time）；创建预约链接 CALENDLY_CREATE_SCHEDULING_LINK（owner、max_event_count）；列出可用性日程 CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES（用户 URI）；获取组织 CALENDLY_GET_ORGANIZATION（uuid）；邀请加入组织 CALENDLY_CREATE_ORGANIZATION_INVITATION（uuid、email）；列出组织邀请 CALENDLY_LIST_ORGANIZATION_INVITATIONS（uuid、status）；撤销组织邀请 CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION（组织 UUID、邀请 UUID）；从组织移除 CALENDLY_REMOVE_USER_FROM_ORGANIZATION（membership UUID）。

【限制】 资料未提供具体价格、收费模式、平台支持范围及效果数据；可用时间查询限制为 7 天范围；组织/组查询可能需要管理员权限；取消操作不可逆。