谷歌日历命令行工具

技能简介

gcalcli 是一个 Python 编写的命令行工具，用于在终端中查看和管理 Google Calendar 日程。该技能采用定制分支版本，支持在 JSON 和 TSV 输出中包含会议附件信息，便于获取 Gemini 会议笔记、录制文件等资料。

业务背景

频繁切换浏览器查看日历打断工作流，且会议资料分散在邮件、Drive 各处。本工具让开发者在终端直接查询日程、批量导出结构化数据，并一键提取 Gemini 笔记、录制文件等附件链接，提升信息获取效率，减少上下文切换成本。

落地案例：工程师每日晨会前执行命令查看当日日程及附件，以 JSON 格式输出后用 jq 筛选出含录制的会议；周报时指定两周日期范围导出 TSV，批量整理参会记录与 AI 笔记链接。需注意使用定制分支版本，避免因 google-api-core 版本冲突导致工具失效。

能做什么

• 查看未来日程安排，支持多种日期范围指定
• 搜索特定关键词的日历事件
• 导出结构化数据（JSON/TSV）供后续处理
• 提取会议附件链接，包括 AI 生成的会议笔记、录制文件、聊天 transcript
• 结合 jq 进行高级过滤和数据筛选

使用说明

安装与运行（必须使用定制分支）：

uvx --from "git+https://github.com/shanemcd/gcalcli@attachments-in-tsv-and-json" --with "google-api-core<2.28.0" gcalcli

首次认证：

1. 运行任意 gcalcli 命令后，浏览器自动打开 Google OAuth 页面
2. 完成授权后，凭证缓存至本地，后续无需重复登录
3. 权限范围：日历读取权限

常用命令示例：

查看今日及以后日程（JSON 完整详情）：

uvx --from "git+https://github.com/shanemcd/gcalcli@attachments-in-tsv-and-json" --with "google-api-core<2.28.0" gcalcli agenda --calendar 你的邮箱@example.com --details all --json

搜索含特定关键词的事件：

uvx --from "git+https://github.com/shanemcd/gcalcli@attachments-in-tsv-and-json" --with "google-api-core<2.28.0" gcalcli search --calendar 你的邮箱@example.com "关键词"

指定日期范围（如明天起两周）：

uvx --from "git+https://github.com/shanemcd/gcalcli@attachments-in-tsv-and-json" --with "google-api-core<2.28.0" gcalcli agenda --calendar 你的邮箱@example.com "tomorrow" "2 weeks"

筛选含 Gemini 笔记的事件（配合 jq）：

uvx --from ... gcalcli search "MCP" --calendar 你的邮箱@example.com --details all --json | jq '.[] | select(.attachments[]? | .attachment_title | contains("Notes by Gemini"))'

注意：agenda 默认从当前时间开始显示，非当日零点。如需查看当天早些时候的事件，需使用绝对日期如 "2025-01-15" "2025-01-15"。

输入与输出

见下方输入与输出表格。

风险提示

• OAuth 凭证存储于本地，共享环境需注意权限隔离
• 定制分支依赖特定 google-api-core 版本（<2.28.0），版本冲突可能导致运行失败
• 附件访问受 Google Drive 权限控制，获取链接不代表有下载权限
• 频繁 API 调用可能触发 Google 速率限制
• 日期解析逻辑特殊（从当前时间而非零点开始），脚本自动化时需特别注意

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/gargravish/gcalcli/SKILL.md
来源类型：GitHub 仓库技能文档