用途:通过 Node 脚本直接访问与操作 Gmail,支持多账户管理、邮件读取、搜索、回复、发送、标签操作与草稿管理。
主要能力:账户管理(列出、链接、解绑,支持命名账户);list.mjs 列出收件箱(可指定标签、数量、翻页);search.mjs 按 Gmail 查询语法搜索(from: to: subject: is:unread has:attachment after: 等);read.mjs 读取单封邮件、完整会话或原始 HTML;reply.mjs 回复并支持抄送、密送与附件;send.mjs 发送新邮件,支持 HTML、抄送、密送与多附件;label.mjs 列出标签并执行标记已读/未读、归档、删除、加星、增删标签;draft.mjs 列出、创建、读取、发送、删除草稿,创建回复草稿时自动填充收件人。
用法:脚本位于 ~/.cursor/skills/gmail/scripts/,可在任意目录运行。所有脚本接受 --account=<name>,默认 default。首次使用需从 Google Cloud Console 获取 OAuth 客户端 JSON(Gmail API → Credentials → OAuth Client ID → Desktop App),保存为 ~/.cursor/skills/gmail/credentials.json,然后运行 node accounts.mjs --link 完成浏览器 OAuth 授权。云环境可通过 GMAIL_CREDENTIALS 与 GMAIL_TOKEN 环境变量(base64 编码)注入凭据,脚本会优先读取环境变量(仅默认账户)。
适用场景:脚本化处理 Gmail 收件箱、批量搜索邮件、自动回复与发送、管理标签与草稿,例如按发件人和主题检索并回复滥用举报邮件。
限制与注意:credentials.json 与 token.json 属敏感文件,已被 gitignore,切勿离开本机;可在 https://myaccount.google.com/permissions 撤销访问。环境变量方式仅支持默认账户。需 Node 运行环境与 Gmail API OAuth 凭据,具体费用、配额与平台支持资料未提供。