gcalcli

📅 终端谷歌日历管理与会议笔记导出

基于成熟开源工具 gcalcli,提供终端查看 Google Calendar、智能搜索会议及批量导出 Gemini AI 笔记的能力,助力高效日程管理与会议准备。

收藏
11.8k
安装
2.8k
版本
2.28.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

该 Skill 本质上是 gcalcli 工具的使用指南,通过 uvx 实现零依赖安装运行,使用户能够在终端环境中与 Google Calendar 进行交互。核心用法涵盖通过 agenda 命令查看日程安排、利用 search 进行事件检索,以及结合 jq 工具对 JSON 输出进行复杂的数据过滤与处理。特别值得关注的是其对会议附件的深度支持,尤其是能够提取并批量导出由 Gemini 生成的 AI 会议笔记,这对需要整理会议纪要的用户极具价值。

显著优点在于其完全基于命令行的设计理念,能够与 grep、awk、jq 等 Unix 工具链无缝集成,非常适合构建自动化工作流。JSON 和 TSV 两种结构化输出格式确保了数据可被程序化解析,避免了传统人工复制粘贴的繁琐。此外,文档详细阐述了时间范围的行为特性(如 "today" 从当前时间而非午夜开始),帮助用户准确获取所需数据。

潜在缺点与局限性同样明显。首先,该 Skill 为纯文档型资产,仅提供使用说明,实际功能依赖外部工具 gcalcli。其次,gcalcli 仅支持只读操作,无法通过 CLI 创建或修改日历事件。更为关键的是,为了获取附件支持,文档推荐使用特定的第三方 fork(shanemcd/gcalcli),这引入了供应链安全风险和维护不确定性。此外,必须经由 Google OAuth 认证才能访问数据,对隐私敏感型用户可能构成顾虑。

适合的目标群体主要包括习惯终端操作的技术人员(开发者、运维工程师)、需要批量处理会议记录并进行知识管理的效率爱好者,以及希望将日程查看集成到自动化脚本中的高级用户。对于依赖图形界面或需要编辑日历功能的普通用户,该 Skill 并不适用。

使用风险方面,数据隐私是首要考量,虽然为只读权限,但仍需授权访问敏感的日历数据。其次,依赖个人维护的代码 fork 存在潜在的安全隐患,建议在使用前审查代码变更。此外,OAuth 凭证可能因过期需定期重新认证,且上游项目的更新可能导致兼容性问题或功能失效。

安全解读

核心用法

gcalcli 是一个开源的 Google Calendar 命令行工具,本 Skill 提供了完整的使用参考文档。主要功能包括:

  • 议程查看gcalcli agenda 命令支持多种输出格式(JSON/TSV/人类可读),可查看特定日期范围的事件
  • 事件搜索gcalcli search 按关键词查找日历事件
  • 附件访问:通过自定义 fork 支持提取会议附件(包括 Google Meet 的 Gemini AI 会议笔记、录像、聊天记录等)
  • 日历管理:列出日历、月视图展示等基础功能

关键特性

  • 必须使用指定 fork(shanemcd/gcalcli@attachments-in-tsv-and-json)才能获取附件数据
  • JSON 输出与 jq 工具配合可实现强大的过滤和数据提取
  • 支持 OAuth 认证,首次使用需浏览器授权

显著优点

1. 结构化数据支持:相比官方版本,该 fork 提供完整的附件数组(attachments),包含 attachment_titleattachment_url,可直接提取 Gemini 会议笔记链接
2. 无代码执行风险:纯文档型 Skill,仅包含使用说明,无可执行代码

3. 来源可信:基于知名开源项目(2900+ Stars),维护者为 Red Hat 员工

4. 集成友好:输出格式支持管道操作,可与 jqgcmd 等工具链式组合实现批量导出

潜在缺点与局限性

  • 读取限制:仅支持查看/搜索事件,文档未涵盖创建/修改事件功能
  • 时间范围陷阱agenda "today" 默认从当前时间开始,非全天事件,易遗漏已结束的日程
  • 依赖特定 fork:功能依赖于个人维护的 fork 分支,长期稳定性存疑
  • OAuth 维护:需定期重新认证,令牌可能过期
  • 版本约束:强制锁定 google-api-core<2.28.0,可能错过安全更新

适合人群

  • 需要自动化处理日历数据的开发者和技术用户
  • 频繁参与 Google Meet 会议、需要批量导出 Gemini AI 会议笔记的用户
  • 偏好命令行工作流、熟悉 jq/uvx 工具链的进阶用户
  • 需要在 CI/CD 或脚本中集成日历查询的自动化场景

常规风险

  • OAuth 授权风险:用户需自行管理 Google 账户授权范围,避免过度授权
  • 供应链安全:依赖 GitHub fork 安装,建议首次使用前审查代码差异
  • 隐私合规:虽然 Skill 本身不收集数据,但实际使用时 gcalcli 会访问用户日历数据,需遵守企业数据政策
  • 数据准确性:时间范围理解错误可能导致遗漏重要会议

gcalcli 内容

手动下载zip · 3.8 kB
SKILL.mdtext/markdown
请选择文件