【计算机工具类-协作工具Skills】cal-com-automation 技能

通过Rube MCP (Composio)自动化Cal.com任务管理预订、检查可用性、配置webhooks和处理团队。始终先搜索工具以获取当前架构。技能概述cal-com-automation 技能通过Composio的Cal工具包和Rube MCP自动化Cal.com日程安排操作。此技能允许AI代理管理预订、检查可用性、配置webhooks和处理团队实现日程安排的自动化流程。下载地址antigravity-awesome-skills/skills/cal-com-automation at main · sickn33/antigravity-awesome-skills · GitHub主要功能预订管理列出、创建和审查预订可用性检查查找空闲/忙碌时间和可用预订时段Webhook配置设置和管理预订事件的webhook通知团队管理处理团队相关的日程安排任务事件类型管理管理不同类型的预订事件日历集成与Google Calendar、Outlook等日历集成触发条件在以下情况下应该使用此技能用户想要列出、创建或审查预订用户想要查找空闲/忙碌时间或可用预订时段用户想要设置或管理预订事件的webhook通知需要管理团队日程安排需要检查特定时间段的可用性前置条件重要使用此技能前需要完成以下设置Rube MCP必须已连接RUBE_SEARCH_TOOLS可用通过RUBE_MANAGE_CONNECTIONS建立活跃的Cal.com连接始终先调用RUBE_SEARCH_TOOLS获取当前工具架构使用场景场景1预订管理用户需要查看现有预订、创建新预订或审查预订详情。场景2可用性检查用户需要查找特定时间段的空闲时间或可用的预订时段。场景3Webhook配置用户需要设置webhook以接收预订事件的实时通知。处理过程1. 设置和连接首先验证Rube MCP可用性然后建立Cal.com连接。1. 验证RUBE_SEARCH_TOOLS响应 2. 调用RUBE_MANAGE_CONNECTIONStoolkit: cal 3. 如果连接未激活按照返回的认证链接完成Cal.com认证 4. 确认连接状态显示ACTIVE2. 预订管理工作流管理预订的工作流程{tool_sequence: [{tool_name: CAL_FETCH_ALL_BOOKINGS,description: 列出所有预订带过滤器,required: true,parameters: {status: {type: string,enum: [upcoming, recurring, past, cancelled, unconfirmed],description: 按预订状态过滤},afterStart: {type: string,format: date-time,description: 过滤此日期之后的预订ISO 8601},beforeEnd: {type: string,format: date-time,description: 过滤此日期之前的预订ISO 8601}}},{tool_name: CAL_POST_NEW_BOOKING_REQUEST,description: 创建新预订,required: false,parameters: {eventTypeId: {type: string,description: 预订的事件类型ID},start: {type: string,format: date-time,description: 预订开始时间ISO 8601},end: {type: string,format: date-time,description: 预订结束时间ISO 8601},name: {type: string,description: 参与者姓名},email: {type: string,format: email,description: 参与者邮箱},timeZone: {type: string,description: 参与者时区IANA格式},language: {type: string,description: 参与者语言代码},metadata: {type: object,description: 其他元数据对象}}}]}3. 可用性检查工作流检查可用性的工作流程{tool_sequence: [{tool_name: CAL_RETRIEVE_CALENDAR_BUSY_TIMES,description: 获取忙碌时间块,required: true,parameters: {}},{tool_name: CAL_GET_AVAILABLE_SLOTS_INFO,description: 获取特定可用时段,required: true,parameters: {dateFrom: {type: string,format: date,description: 可用性检查开始日期YYYY-MM-DD},dateTo: {type: string,format: date,description: 可用性检查结束日期YYYY-MM-DD},eventTypeId: {type: string,description: 检查时段的事件类型},timeZone: {type: string,description: 可用性响应的时区},loggedInUsersTz: {type: string,description: 请求用户的时区}}}]}4. Webhook配置工作流配置webhooks的工作流程{tool_sequence: [{tool_name: CAL_RETRIEVE_WEBHOOKS_LIST,description: 列出现有webhooks,required: true,parameters: {}},{tool_name: CAL_GET_WEBHOOK_BY_ID,description: 获取特定webhook详情,required: false,parameters: {id: {type: string,description: Webhook ID}}},{tool_name: CAL_UPDATE_WEBHOOK_BY_ID,description: 更新webhook配置,required: false,parameters: {id: {type: string,description: Webhook ID},subscriberUrl: {type: string,format: uri,description: Webhook端点URL},eventTriggers: {type: array,items: {type: string},description: 触发事件类型数组},active: {type: boolean,description: Webhook是否激活},secret: {type: string,description: Webhook签名密钥}}},{tool_name: CAL_DELETE_WEBHOOK_BY_ID,description: 删除webhook,required: false,parameters: {id: {type: string,description: Webhook ID}}}]}输入要求使用此技能需要提供以下输入Rube MCP连接必须先配置Rube MCP服务器Cal.com认证需要完成Cal.com认证流程事件类型ID要预订的事件类型ID时间参数开始时间、结束时间、时区等参与者信息姓名、邮箱、语言等Webhook参数订阅URL、事件触发器、密钥等输出说明此技能提供以下输出预订列表所有预订及其状态和详情预订详情特定预订的完整信息忙碌时间日历中不可用的时间块可用时段可以预订的时间段Webhook列表所有已配置的webhooksWebhook详情特定webhook的配置信息关键参数说明参数说明用途eventTypeId事件类型ID指定预订的事件类型status预订状态按状态过滤预订start/end开始/结束时间预订的时间范围ISO 8601格式timeZone时区IANA格式的时区字符串如America/New_YorkdateFrom/dateTo日期范围可用性检查的日期范围YYYY-MM-DDsubscriberUrl订阅URLWebhook接收通知的端点常见陷阱注意事项日期过滤器使用ISO 8601格式和时区如2024-01-15T09:00:00ZeventTypeId必须引用有效、活跃的事件类型创建预订需要匹配可用时段先检查可用性时区必须是有效的IANA时区字符串状态过滤器值是特定字符串无效值返回空结果忙碌时间显示用户不可用的时间可用时段特定于事件类型的持续时间和配置日期范围应合理不要提前数月以获得准确结果使用示例示例1列出即将到来的预订{tool_name: CAL_FETCH_ALL_BOOKINGS,parameters: {status: upcoming,afterStart: 2026-01-01T00:00:00Z}}示例2检查可用性并创建预订{tool_sequence: [{tool_name: CAL_GET_AVAILABLE_SLOTS_INFO,parameters: {dateFrom: 2026-01-15,dateTo: 2026-01-15,eventTypeId: 12345,timeZone: America/New_York}},{tool_name: CAL_POST_NEW_BOOKING_REQUEST,parameters: {eventTypeId: 12345,start: 2026-01-15T10:00:00Z,end: 2026-01-15T10:30:00Z,name: 张三,email: zhangsanexample.com,timeZone: America/New_York}}]}示例3配置Webhook{tool_name: CAL_CREATE_WEBHOOK,parameters: {subscriberUrl: https://myapp.com/webhooks/cal,eventTriggers: [BOOKING_CREATED, BOOKING_CANCELLED],active: true,secret: my_webhook_secret}}最佳实践提示始终先调用RUBE_SEARCH_TOOLS获取最新的工具架构在执行操作前验证连接状态为ACTIVE创建预订前先检查可用性使用正确的IANA时区格式合理设置日期范围以获得准确的可用性结果为webhook配置签名密钥以确保安全性定期检查webhook状态以确保通知正常工作设置指南获取Rube MCP在客户端配置中将https://rube.app/mcp添加为MCP服务器。无需API密钥 - 只需添加端点即可使用。风险等级警告此技能风险等级为 CRITICAL此技能涉及预订管理和日程安排可能影响重要的时间安排。使用时请确保仔细验证预订时间和参与者信息在创建预订前确认时间可用及时通知参与者预订变更遵守组织的日程安排政策保护参与者隐私信息相关资源GitHub仓库Rube MCP文档Composio Cal工具包Cal.com API文档