名称： gogcli
描述： 用于 Gmail、日历、Drive、Sheets、Docs、Slides、联系人、任务、People、群组、Keep 的 Google Workspace 命令行工具。当用户需要与 Google 服务交互时使用。

gogcli - Google Workspace 命令行工具

概述

gogcli 是一个用于在终端管理 Google Workspace 服务的命令行工具。支持 Gmail、日历、Drive、Sheets、Docs、Slides、联系人、任务、People、群组和 Keep。

安装

快速安装（如果已安装 brew）：

brew install steipete/tap/gogcli

从源码构建（无 brew）：

# 1. 克隆仓库
git clone https://github.com/steipete/gogcli.git

# 2. 进入目录
cd gogcli

# 3. 构建
make

# 4. （可选）全局安装
sudo make install

首次设置

使用 gogcli 前，需先设置 OAuth 凭据：

步骤 1：获取 OAuth 客户端凭据
1. 访问 Google Cloud Console APIs & Services
2. 创建新项目或使用现有项目
3. 进入 OAuth 同意屏幕
4. 创建 OAuth 2.0 客户端，设置如下：
- 应用类型："桌面应用"
- 名称："gogcli for Clawdbot"
- 授权重定向 URI：http://localhost:8085/callback
5. 启用所需 API
6. 下载 OAuth 客户端凭据 JSON 文件
7. 复制到 ~/Downloads/ 目录

步骤 2：授权账户

cd gogcli
./bin/gog auth add you@gmail.com ~/Downloads/client_secret_....json

步骤 3：验证

./bin/gog auth list
./bin/gog gmail search 'is:unread' --max 5

常用命令

Gmail

# 搜索邮件
./bin/gog gmail search '查询语句' --max 20

# 发送邮件
./bin/gog gmail send 'recipient@gmail.com' --subject '标题' --body '正文'

# 标签管理
./bin/gog gmail labels list

日历

# 列出事件
./bin/gog calendar events list --max 50

# 创建事件
./bin/gog calendar events create '会议' --start '2026-01-30T10:00'

Drive

# 列出文件
./bin/gog drive ls --query 'pdf' --max 20

# 上传文件
./bin/gog drive upload ~/Documents/file.pdf

Sheets

# 列出表格
./bin/gog sheets list

# 导出表格
./bin/gog sheets export <电子表格ID> --format pdf

联系人

./bin/gog contacts search '姓名'

任务

# 列出任务列表
./bin/gog tasks list

# 添加任务
./bin/gog tasks add --title '任务标题' --due '2026-01-30'

注意事项

• 使用 --json 标志进行脚本处理
• 凭据存储在 ~/.config/gog/ 目录
• 使用 gog auth list 检查认证状态