Google Calendar CLI

使用 gog 命令行工具高效管理 Google Calendar 事件。

前提条件

安装 gog

brew install steipete/tap/gogcli

身份验证配置

# 配置 OAuth 凭据
gog auth credentials /path/to/client_secret.json

# 添加具有日历访问权限的 Google 账户
gog auth add you@gmail.com --services calendar

# 验证身份验证状态
gog auth list

快速开始

列出事件

# 列出主日历中的事件（仅今日事件）
gog calendar events primary --from "2026-01-01T00:00:00Z" --to "2026-01-01T23:59:59Z"

# 列出未来 7 天的事件
gog calendar events primary --from "$(date -u +%Y-%m-%dT00:00:00Z)" --to "$(date -u -v+7d +%Y-%m-%dT23:59:59Z)"

创建事件

# 创建基础事件
gog calendar create primary --summary "Team Meeting" --from "2026-01-15T14:00:00+01:00" --to "2026-01-15T15:00:00+01:00"

# 创建带颜色的事件
gog calendar create primary --summary "Important Deadline" --from "2026-01-20T00:00:00+01:00" --to "2026-01-20T23:59:59+01:00" --event-color 11

更新事件

# 更新事件标题与颜色
gog calendar update primary  --summary "Updated Meeting Title" --event-color 4

事件颜色

# 查看所有可用颜色
gog calendar colors

常见工作流

查找空闲时间段

# 列出所有事件以直观查看空闲时段
gog calendar events primary --from "2026-01-15T00:00:00Z" --to "2026-01-21T23:59:59Z" --json

安排周期性事件（概念）

注意：gog CLI 不直接支持周期性事件，但可通过脚本实现：

# 通过脚本创建多个事件（示例）
for i in {1..5}; do
  DATE=$(date -v+${i}d +%Y-%m-%d)
  gog calendar create primary --summary "Daily Standup" 
    --from "${DATE}T09:00:00+01:00" --to "${DATE}T09:30:00+01:00" 
    --event-color 1
done

批量操作

# 设置默认账户以避免重复指定
export GOG_ACCOUNT=you@gmail.com

# 后续命令无需再加 --account 参数
gog calendar events primary --from "..." --to "..."

高效使用技巧

1. 使用 ISO 8601 时间戳：务必包含时区偏移量
2. 使用 JSON 输出便于脚本处理：添加 --json 参数获取机器可读输出
3. 配合 --no-input 执行批处理：在自动化脚本中使用该参数跳过交互式提示
4. 主日历快捷方式：对主日历可直接使用 "primary" 作为日历 ID

示例脚本：周议程检查

#!/bin/bash
# 获取本周所有事件
START=$(date -u -v-Monday +%Y-%m-%dT00:00:00Z)
END=$(date -u -v+Sunday +%Y-%m-%dT23:59:59Z)
gog calendar events primary --from "$START" --to "$END" --json