用途:通过 Composio 的 cal 工具包经 Rube MCP 自动化 Cal.com 的排程操作,覆盖预约管理、可用性查询、Webhook 配置、团队与组织管理。工具包文档见 composio.dev/toolkits/cal。
前置条件:Rube MCP 已连接(RUBE_SEARCH_TOOLS 可用);已通过 RUBE_MANAGE_CONNECTIONS 激活 cal 连接;每次先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。
设置:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务器,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit cal;若连接非 ACTIVE,按返回的认证链接完成 Cal.com 认证,确认状态为 ACTIVE 后再运行工作流。
主要能力: 预约管理:CAL_FETCH_ALL_BOOKINGS 按 status、afterStart、beforeEnd 列出预约;CAL_POST_NEW_BOOKING_REQUEST 用 eventTypeId、start、end、name、email、timeZone、language、metadata 创建预约。 可用性查询:CAL_RETRIEVE_CALENDAR_BUSY_TIMES 与 CAL_GET_AVAILABLE_SLOTS_INFO,参数含 dateFrom、dateTo、eventTypeId、timeZone、loggedInUsersTz。 Webhook:CAL_RETRIEVE_WEBHOOKS_LIST、CAL_GET_WEBHOOK_BY_ID、CAL_UPDATE_WEBHOOK_BY_ID、CAL_DELETE_WEBHOOK_BY_ID,涉及 id、subscriberUrl、eventTriggers、active、secret。 团队与组织:CAL_GET_TEAMS_LIST、CAL_GET_TEAM_INFORMATION_BY_TEAM_ID、CAL_CREATE_TEAM_IN_ORGANIZATION(name、slug)、CAL_RETRIEVE_TEAM_EVENT_TYPES、CAL_GET_ORGANIZATION_ID。
典型流程:创建预约前先查询可用时段再提交;通过团队列表按名称解析 teamId;Webhook 先列出既有项再创建或更新并用测试预约验证。
限制:日期时间格式须规范,预约用 ISO 8601 带时区,可用性日期用 YYYY-MM-DD,须显式指定时区;eventTypeId 须为有效且启用的整数 ID;团队与组织操作需相应权限,非所有账户都有组织;Webhook URL 须为公开 HTTPS;API 有速率限制,遇 429 应退避重试。