通过 Rube MCP 实现 Cal.com 自动化

借助 Composio 提供的 Cal 工具包，通过 Rube MCP 自动化 Cal.com 的日程调度操作。

前提条件

• Rube MCP 必须已连接（确保 RUBE_SEARCH_TOOLS 可用）
• 已通过 RUBE_MANAGE_CONNECTIONS 建立活跃的 Cal.com 连接，且工具包为 cal
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前可用工具的 Schema

配置步骤

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

1. 确认 RUBE_SEARCH_TOOLS 能正常响应，以验证 Rube MCP 是否可用
2. 调用 RUBE_MANAGE_CONNECTIONS，指定工具包 cal
3. 若连接状态非 ACTIVE，请按返回的认证链接完成 Cal.com 授权流程
4. 在执行任何工作流前，请确认连接状态显示为 ACTIVE

核心工作流

1. 管理预约（Bookings）

适用场景：用户希望列出、创建或查看预约

工具调用顺序：

1. CAL_FETCH_ALL_BOOKINGS — 按筛选条件列出全部预约 [必需]
2. CAL_POST_NEW_BOOKING_REQUEST — 创建新预约 [可选]

列出预约的关键参数：

• status：按预约状态筛选（如 'upcoming'、'recurring'、'past'、'cancelled'、'unconfirmed'）
• afterStart：筛选开始时间在此日期之后的预约（ISO 8601 格式）
• beforeEnd：筛选结束时间在此日期之前的预约（ISO 8601 格式）

创建预约的关键参数：

• eventTypeId：预约所关联的事件类型 ID
• start：预约开始时间（ISO 8601 格式）
• end：预约结束时间（ISO 8601 格式）
• name：参会者姓名
• email：参会者邮箱
• timeZone：参会者时区（IANA 格式）
• language：参会者语言代码
• metadata：额外元数据对象

常见陷阱：

• 日期筛选参数必须使用带时区的 ISO 8601 格式（例如 '2024-01-15T09:00:00Z'）
• eventTypeId 必须引用一个有效且处于启用状态的事件类型
• 创建预约需匹配一个可用时段；请务必先检查可用性
• 时区必须为合法的 IANA 时区字符串（例如 'America/New_York'）
• 状态筛选值为固定字符串；传入非法值将导致返回空结果

2. 检查可用性（Availability）

适用场景：用户希望查询空闲/忙碌时间段，或获取可预约的时间段

工具调用顺序：

1. CAL_RETRIEVE_CALENDAR_BUSY_TIMES — 获取忙碌时间段 [必需]
2. CAL_GET_AVAILABLE_SLOTS_INFO — 获取具体的可预约时间段 [必需]

关键参数：

• dateFrom：可用性检查的起始日期（格式：YYYY-MM-DD）
• dateTo：可用性检查的结束日期（格式：YYYY-MM-DD）
• eventTypeId：待检查可用时间段的事件类型
• timeZone：可用性响应所使用的时区
• loggedInUsersTz：发起请求用户的时区

常见陷阱：

• “忙碌时间”表示用户不可用的时间段
• 可预约时间段取决于对应事件类型的持续时间和配置规则
• 建议设置合理的日期范围（不建议数月之后），以获得准确结果
• 时区会影响时间段的展示方式；请始终显式指定
• 可用性信息来源于日历集成（如 Google Calendar、Outlook 等）

3. 配置 Webhook

适用场景：用户希望设置或管理针对预约事件的 Webhook 通知

工具调用顺序：

1. CAL_RETRIEVE_WEBHOOKS_LIST — 列出已存在的 Webhook [必需]
2. CAL_GET_WEBHOOK_BY_ID — 获取特定 Webhook 的详细信息 [可选]
3. CAL_UPDATE_WEBHOOK_BY_ID — 更新 Webhook 配置 [可选]
4. CAL_DELETE_WEBHOOK_BY_ID — 删除某个 Webhook [可选]

关键参数：

• id：用于 GET / UPDATE / DELETE 操作的 Webhook ID
• subscriberUrl：Webhook 回调地址（URL）
• eventTriggers：触发 Webhook 的事件类型数组
• active：Webhook 是否启用
• secret：Webhook 签名密钥

常见陷阱：

• Webhook URL 必须是公开可访问的 HTTPS 地址
• 支持的事件触发类型包括：'BOOKING_CREATED'、'BOOKING_RESCHEDULED'、'BOOKING_CANCELLED' 等
• 未启用的 Webhook 不会触发；通过切换 active 字段控制启停
• Webhook secret 用于校验请求负载（payload）签名

4. 管理团队（Teams）

适用场景：用户希望创建、查看或管理团队及其团队级事件类型

工具调用顺序：

1. CAL_GET_TEAMS_LIST — 列出所有团队 [必需]
2. CAL_GET_TEAM_INFORMATION_BY_TEAM_ID — 获取指定团队详情 [可选]
3. CAL_CREATE_TEAM_IN_ORGANIZATION — 在组织内创建新团队 [可选]
4. CAL_RETRIEVE_TEAM_EVENT_TYPES — 列出某团队下的事件类型 [可选]

关键参数：

• teamId：团队标识符
• name：团队名称（用于创建）
• slug：URL 友好的团队标识符

常见陷阱：

• 创建团队可能需要组织级别的权限
• 团队事件类型与个人事件类型相互独立
• 团队 slug 必须符合 URL 安全规范，并在组织内唯一

5. 组织管理（Organization Management）

适用场景：用户希望查看组织相关信息

工具调用顺序：

1. CAL_GET_ORGANIZATION_ID — 获取组织 ID [必需]

关键参数：（无必需参数）

常见陷阱：

• 组织 ID 是执行团队创建及组织级操作所必需的
• 并非所有 Cal.com 账户都具备组织结构；个人计划账户可能返回错误

常用模式

预约创建流程

1. 调用 CAL_GET_AVAILABLE_SLOTS_INFO 查询可用时间段
2. 将可用时间呈现给用户
3. 使用选定时间段调用 CAL_POST_NEW_BOOKING_REQUEST 创建预约
4. 确认预约创建响应成功

ID 解析流程

团队名称 → 团队 ID：

1. 调用 CAL_GET_TEAMS_LIST
2. 在响应中根据名称查找目标团队
3. 提取其 id 字段

Webhook 配置流程

1. 调用 CAL_RETRIEVE_WEBHOOKS_LIST 检查已有 Webhook
2. 创建或更新 Webhook，并配置所需事件触发类型
3. 通过测试预约验证 Webhook 是否正常触发

已知陷阱

日期/时间格式：

• 预约时间：带时区的 ISO 8601 格式（例如 '2024-01-15T09:00:00Z'）
• 可用性日期：YYYY-MM-DD 格式
• 请始终显式指定时区，避免歧义

事件类型（Event Types）：

• 事件类型 ID 为数值型整数
• 事件类型定义了持续时间、地点及预约规则
• 已禁用的事件类型无法接受新的预约

权限要求：

• 团队相关操作需具备团队成员身份或管理员权限
• 组织级操作需具备组织层级权限
• Webhook 管理需具备相应访问权限

速率限制（Rate Limits）：

• Cal.com API 对每个 API Key 设有速率限制
• 遇到 HTTP 429 响应时，请实现退避重试机制

快速参考表