---

name: cal-com-automation description: "通过 Rube MCP (Composio) 自动化 Cal.com 任务：管理预约、检查可用时间、配置 Webhooks 和处理团队。始终先搜索工具以获取当前 schema。" risk: critical source: community date_added: "2026-02-27"

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

通过 Composio 的 Cal 工具包经由 Rube MCP 自动化 Cal.com 日程安排操作。

前置条件

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

设置

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

1. 确认 RUBE_SEARCH_TOOLS 响应以验证 Rube MCP 可用
2. 使用工具包 cal 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Cal.com 身份验证
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 管理预约

使用场景：用户想要列出、创建或查看预约

工具调用顺序：

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. 检查可用性

使用场景：用户想要查找空闲/忙碌时间或可用预约时段

工具调用顺序：

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. 配置 Webhooks

使用场景：用户想要设置或管理预约事件的 Webhook 通知

工具调用顺序：

1. CAL_RETRIEVE_WEBHOOKS_LIST - 列出现有 Webhooks [必需]
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：触发事件类型数组
• active：Webhook 是否激活
• secret：Webhook 签名密钥

注意事项：

• Webhook URL 必须是可公开访问的 HTTPS 端点
• 事件触发器包括：'BOOKING_CREATED'、'BOOKING_RESCHEDULED'、'BOOKING_CANCELLED' 等
• 未激活的 Webhooks 不会触发；切换 active 来启用/禁用
• Webhook 密钥用于负载签名验证

4. 管理团队

使用场景：用户想要创建、查看或管理团队和团队事件类型

工具调用顺序：

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. 组织管理

使用场景：用户想要查看组织信息