用途：在 Claude Code 环境中通过 CLI 以编程方式访问 Gmail，读取与搜索邮件、导出邮件、创建与管理草稿。
主要能力：list 列出最近邮件；search 按查询和日期检索；read 读取指定 message_id 的完整正文，支持 --save-images 保存内嵌图片、--image-dir 指定目录、--save-attachments 与 --attachment-dir 下载真实附件；export 将搜索结果导出为 JSON，含正文、内嵌图片与附件元数据；draft 创建草稿或草稿回复（--reply-to），支持 --body、--body-file 和可重复的 --attach；drafts 列出草稿；draft-update 以删除重建方式替换草稿。多数命令支持 --json。
使用方式：先完成强制预检。检查 CLI 二进制是否存在，缺失时执行 cd ~/.claude/plugins/marketplaces/cc-skills/plugins/gmail-commander/scripts/gmail-cli && bun install --frozen-lockfile && bun run build；检查 GMAIL_OP_UUID 是否设置，未设置则走 Setup Flow（需 1Password CLI，可用 brew install 1password-cli 安装），确认账号上下文并验证令牌健康。命令形如 $GMAIL_CLI list -n 10、$GMAIL_CLI search "from:alice after:2026/01/27" -n 10。
注意事项：多账号时不要用 list 输出推断邮箱归属，应查询 users/me/profile；drafts 的标识字段是 draftId 而非 id，draft-update 会返回新的 draftId；涉及引用或归因发件人内容时需先运行归因脚本，信号冲突时报告 CONFLICT 或 UNKNOWN，宁可回答无法确定也不做错误归因。资料未提供收费、价格与平台范围等信息。