
关于
通过 Rube MCP(Composio)自动化 Cal.com 任务:管理预约、检查可用性、配置 Webhook 和处理团队。使用前请先搜索工具获取当前 Schema
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 密钥——只需添加端点即可使用。
- 确认
RUBE_SEARCH_TOOLS响应以验证 Rube MCP 可用 - 使用工具包
cal调用RUBE_MANAGE_CONNECTIONS - 如果连接不是 ACTIVE 状态,按照返回的认证链接完成 Cal.com 身份验证
- 确认连接状态显示 ACTIVE 后再运行任何工作流
核心工作流
1. 管理预约
使用场景:用户想要列出、创建或查看预约
工具调用顺序:
CAL_FETCH_ALL_BOOKINGS- 列出所有预约并支持筛选 [必需]CAL_POST_NEW_BOOKING_REQUEST- 创建新预约 [可选]
列表关键参数:
status:按预约状态筛选('upcoming'、'recurring'、'past'、'cancelled'、'unconfirmed')afterStart:筛选此日期之后的预约(ISO 8601)beforeEnd:筛选此日期之前的预约(ISO 8601)
创建关键参数:
eventTypeId:预约的事件类型 IDstart:预约开始时间(ISO 8601)end:预约结束时间(ISO 8601)name:参与者姓名email:参与者邮箱timeZone:参与者时区(IANA 格式)language:参与者语言代码metadata:附加元数据对象
注意事项:
- 日期筛选使用带时区的 ISO 8601 格式(例如 '2024-01-15T09:00:00Z')
eventTypeId必须引用有效的活跃事件类型- 创建预约需要匹配可用时段;请先检查可用性
- 时区必须是有效的 IANA 时区字符串(例如 'America/New_York')
- 状态筛选值是特定字符串;无效值将返回空结果
2. 检查可用性
使用场景:用户想要查找空闲/忙碌时间或可用预约时段
工具调用顺序:
CAL_RETRIEVE_CALENDAR_BUSY_TIMES- 获取忙碌时间段 [必需]CAL_GET_AVAILABLE_SLOTS_INFO- 获取具体可用时段 [必需]
关键参数:
dateFrom:可用性检查的开始日期(YYYY-MM-DD)dateTo:可用性检查的结束日期(YYYY-MM-DD)eventTypeId:要检查时段的事件类型timeZone:可用性响应的时区loggedInUsersTz:请求用户的时区
注意事项:
- 忙碌时间显示用户不可用的时段
- 可用时段取决于事件类型的时长和配置
- 日期范围应合理(不要提前数月)以获得准确结果
- 时区影响时段的显示方式;始终明确指定
- 可用性反映日历集成(Google Calendar、Outlook 等)
3. 配置 Webhooks
使用场景:用户想要设置或管理预约事件的 Webhook 通知
工具调用顺序:
CAL_RETRIEVE_WEBHOOKS_LIST- 列出现有 Webhooks [必需]CAL_GET_WEBHOOK_BY_ID- 获取特定 Webhook 详情 [可选]CAL_UPDATE_WEBHOOK_BY_ID- 更新 Webhook 配置 [可选]CAL_DELETE_WEBHOOK_BY_ID- 删除 Webhook [可选]
关键参数:
id:用于 GET/UPDATE/DELETE 操作的 Webhook IDsubscriberUrl:Webhook 端点 URLeventTriggers:触发事件类型数组active:Webhook 是否激活secret:Webhook 签名密钥
注意事项:
- Webhook URL 必须是可公开访问的 HTTPS 端点
- 事件触发器包括:'BOOKING_CREATED'、'BOOKING_RESCHEDULED'、'BOOKING_CANCELLED' 等
- 未激活的 Webhooks 不会触发;切换
active来启用/禁用 - Webhook 密钥用于负载签名验证
4. 管理团队
使用场景:用户想要创建、查看或管理团队和团队事件类型
工具调用顺序:
CAL_GET_TEAMS_LIST- 列出所有团队 [必需]CAL_GET_TEAM_INFORMATION_BY_TEAM_ID- 获取特定团队详情 [可选]CAL_CREATE_TEAM_IN_ORGANIZATION- 创建新团队 [可选]CAL_RETRIEVE_TEAM_EVENT_TYPES- 列出团队的事件类型 [可选]
关键参数:
teamId:团队标识符name:团队名称(用于创建)slug:URL 友好的团队标识符
注意事项:
- 创建团队可能需要组织级别的权限
- 团队事件类型与个人事件类型是分开的
- 团队 slug 必须是 URL 安全的且在组织内唯一
5. 组织管理
使用场景:用户想要查看组织信息
兼容工具
Claude CodeCursor
标签
后端开发
