ez-google

面向智能体的Google Workspace工具。简单的CLI脚本，使用托管OAuth——用户只需点击链接并粘贴回令牌。无需API密钥或凭据。

所有命令运行方式： uv run scripts/<脚本名>.py <命令> [参数]

认证（请先执行此步骤）

bash
auth.py status # 检查：AUTHENTICATED（已认证）或NOT_AUTHENTICATED（未认证）
auth.py login # 获取URL → 发送给用户
auth.py save # 保存来自托管OAuth的令牌

认证流程： status → 如果未认证 → login → 用户点击链接，复制令牌 → save

Gmail

bash
gmail.py list [-n 10] [-q 查询条件] # 列出邮件
gmail.py search 查询条件 # 搜索邮件
gmail.py get 消息ID # 阅读邮件
gmail.py send 收件人 主题 正文 # 发送邮件
gmail.py draft 收件人 主题 正文 # 创建草稿
gmail.py labels # 列出标签

批量操作（每次API调用最多处理1000封邮件）

批量操作示例：
bash
gmail.py bulk-label from:newsletter@example.com --add ARCHIVE --remove INBOX
gmail.py bulk-trash subject:alert older_than:30d -y
gmail.py bulk-label category:promotions --add Label_3 # 使用labels命令获取的标签ID

日历

bash
gcal.py list [日期] # 列出事件（日期格式：YYYY-MM-DD或today）
gcal.py create 标题 开始时间 结束时间 # 创建事件（开始/结束时间格式：YYYY-MM-DDTHH:MM）
gcal.py get 事件ID # 事件详情
gcal.py delete 事件ID # 删除事件
gcal.py calendars # 列出日历

云端硬盘

bash
drive.py list [-n 20] # 列出文件
drive.py search 查询条件 # 按名称搜索
drive.py get 文件ID # 文件元数据
drive.py download 文件ID # 文件内容
drive.py create-folder 名称 # 创建文件夹

文档

bash
docs.py create 标题 # 创建文档
docs.py get 文档ID # 读取内容
docs.py find 查询条件 # 按标题查找
docs.py append 文档ID 文本 # 追加文本
docs.py insert 文档ID 文本 # 在开头插入
docs.py replace 文档ID 旧文本 新文本 # 替换文本

表格

bash
sheets.py create 标题 # 创建电子表格
sheets.py get ID Sheet!A1:D10 # 读取数据
sheets.py info ID # 表格元数据
sheets.py find 查询条件 # 按名称查找
sheets.py write ID Sheet!A1 a,b;c,d # 写入（行之间用;分隔）
sheets.py append ID Sheet!A:B a,b;c,d # 追加行

幻灯片

bash
slides.py find 查询条件 # 查找演示文稿
slides.py get 演示文稿ID # 获取幻灯片信息
slides.py text 演示文稿ID # 提取所有文本
slides.py create 标题 # 创建演示文稿

联系人

bash
people.py me # 当前用户资料
people.py contacts [-n 100] # 列出联系人
people.py search 姓名 # 搜索联系人
people.py get 联系人ID # 联系人详情

聊天（仅限Workspace）

bash
chat.py spaces # 列出空间
chat.py messages 空间ID [-n 20] # 列出消息
chat.py send 空间ID 文本 # 发送消息
chat.py get 空间ID # 空间详情