SuperAPI AI 工具集

google-calendar-automation

办公与效率

查看项目

更新于 10-16 05:06

技能介绍

用途:在本地脚本中轻量集成 Google Calendar,通过独立 OAuth 认证完成日历自动化,无需搭建 MCP 服务器。适用于需要列出、创建、查看或更新日历事件,以及访问日历、日程、参与人或事件详情的 Workspace 环境。

主要能力:列出日历与事件、获取事件详情、创建/更新/删除事件、查找空闲时间、回复事件邀请。所有操作通过 scripts/gcal.py 执行,首次使用未登录时自动认证。

使用方式:认证命令为 python scripts/auth.py login(打开浏览器),状态检查 python scripts/auth.py status,登出 python scripts/auth.py logout。常用命令包括 python scripts/gcal.py list-calendars、list-events(默认未来 30 天,可用 --time-min/--time-max/--calendar/--max-results)、get-event EVENT_ID、create-event、update-event、delete-event、find-free-time、respond-to-event。时间使用 ISO 8601 带时区格式,如 2024-01-15T10:30:00Z 或 2024-01-15T10:30:00-05:00。主日历用 primary 或省略 --calendar,其他日历用 list-calendars 返回的 ID。

限制:需要 Google Workspace 账号,个人 Gmail 账号不支持。令牌通过系统钥匙串存储(macOS Keychain、Windows Credential Locker、Linux Secret Service API),服务名 google-calendar-skill-oauth,过期自动刷新。输出不能替代环境特定验证、测试或专家审查;缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。