用途：通过命令行读取、搜索、发送和草拟 Gmail 邮件，并访问 Google 联系人，适合在 Claude 等环境中处理邮箱任务。
主要能力：搜索邮件（支持 from、subject、after、has:attachment、is:unread 等查询语法）、读取指定邮件、列出最近邮件、发送邮件、创建草稿、标记已读/未读、归档/取消归档、加星/取消星、列出标签、列出与搜索联系人、管理多账号。所有命令输出 JSON。
使用方式：首次运行需创建 Google Cloud OAuth 客户端，启用 Gmail API 与 People API，配置 OAuth 同意屏幕并添加 gmail.readonly、gmail.send、gmail.modify、contacts.readonly 权限，下载 JSON 保存为 ~/.claude/skills/gmail-skill/credentials.json。依赖 Python 3.9+，安装命令：pip install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client requests。常用命令如：python3 ~/.claude/skills/gmail-skill/gmail_skill.py search "query"、read EMAIL_ID、list、send --to EMAIL --subject "Subject" --body "Body text"、draft、contacts、search-contacts "query"、accounts、logout --account EMAIL。多账号通过 --account 指定，令牌按账号存于 ~/.claude/skills/gmail-skill/tokens/。
限制与注意：发送任何邮件前必须向用户展示完整邮件详情并获得明确确认，即使处于跳过权限模式也不例外。草稿与发送支持 --body-file、--attach、--reply-to-id 等选项，消息格式兼容 Superhuman。测试模式应用可能每 7 天需重新认证，可发布应用避免。可随时在 Google 账户权限页撤销访问。