---

name: gog description: Google Workspace 命令行工具，支持 Gmail、日历、Drive、通讯录、表格和文档。 homepage: https://gogcli.sh metadata: {"clawdbot":{"emoji":"🎮","requires":{"bins":["gog"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"安装 gog (brew)"}]}}

gog

使用 gog 管理 Gmail/日历/Drive/通讯录/表格/文档。需配置 OAuth 认证。

初始设置（一次性操作）

• gog auth credentials /path/to/client_secret.json
• gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs
• gog auth list

常用命令

• Gmail 搜索：gog gmail search 'newer_than:7d' --max 10
• Gmail 发送：gog gmail send --to a@b.com --subject "你好" --body "您好"
• 日历：gog calendar events <calendarId> --from <iso> --to <iso>
• Drive 搜索：gog drive search "查询词" --max 10
• 通讯录：gog contacts list --max 20
• 表格获取：gog sheets get <sheetId> "工作表!A1:D10" --json
• 表格更新：gog sheets update <sheetId> "工作表!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• 表格追加：gog sheets append <sheetId> "工作表!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• 表格清空：gog sheets clear <sheetId> "工作表!A2:Z"
• 表格元数据：gog sheets metadata <sheetId> --json
• 文档导出：gog docs export <docId> --format txt --out /tmp/doc.txt
• 文档查看：gog docs cat <docId>

注意事项

• 设置 GOG_ACCOUNT=you@gmail.com 可避免重复输入 --account。
• 脚本编写建议使用 --json 配合 --no-input。
• 表格数据可通过 --values-json 传递（推荐）或直接输入行数据。
• 文档支持导出/查看/复制。原地编辑需要 Docs API 客户端（gog 不提供）。
• 发送邮件或创建日程前请确认。