✉️

Gmail

读写 Gmail — 列邮件 / 搜索 / 起草 / 发送 / 附件 (OAuth 接入硬核, 国内需翻墙)

难度: hard见效: 30min更新: 2026-05-16
✅ 适合
  • · 海外业务为主, Gmail 是主邮箱
  • · 个人客服 / 销售, Gmail 邮件 100+/日
  • · 想让 AI 替你写回复 / 起草
❌ 不适合
  • · 国内用户 (Gmail 被墙, 翻墙才能用)
  • · 用 Outlook / 阿里邮箱 / 网易企业邮箱的
  • · 跨境 B2B 主流 Outlook

这是什么

Gmail MCP 让 AI 在对话中:

  • 列你最近邮件
  • 搜邮件 (按主题 / 发件人 / 时间)
  • 起草回复 (用 W6 用户画像)
  • 发送邮件 (可选, 默认关)
  • 看附件内容

⚠️ 当前状态: 不推荐用

W7 时实现完整后端, 但实际没真用户跑通:

  1. OAuth 流程硬核 — 5 步 (Google Cloud Console 注册 OAuth App → 拿 client_id/secret → OAuth Playground 拿 refresh_token), 普通用户卡 step 1 就放弃
  2. 国内全套被墙 — accounts.google.com / console.cloud.google.com 都被墙, 必须翻墙
  3. 跨境 B2B 主流 Outlook 不是 Gmail
  4. 维护成本高 — Google 不定期改 API, 我们要跟

替代方案

你的需求推荐
让 AI 帮我写客服回复客服话术 skill + Gmail 网页 复制粘贴
邮件营销批量发邮件营销 skill + 用 Mailchimp / SendGrid 等
看附件 PDF 文档files-local MCP (上传 PDF 让 AI 读)
真要 Gmail 集成联系 wc6895@gmail.com, 我们做 OAuth Connect (产品方向)

长远计划

我们规划做 OAuth Connect 一键授权:

  • 用户点 "用 Google 登录" 按钮
  • 跳 Google 授权页 (绕过用户自己注册 OAuth App)
  • 30 秒授权完
  • AI 立刻能用

这是产品 backlog 中的 W14+ 项目, 视用户需求触发.

现状下怎么填 refresh_token

如果你坚持要用:

  1. Google Cloud Console (https://console.cloud.google.com/apis/credentials):
    • 注册 OAuth App, 类型 "Web application"
    • Redirect URI: https://developers.google.com/oauthplayground
  2. 拿 client_id / client_secret
  3. OAuth Playground (https://developers.google.com/oauthplayground/):
    • 齿轮 → "Use your own OAuth credentials" → 填 client_id/secret
    • Step 1: 选 Gmail API scope (https://mail.google.com/)
    • Authorize APIs → 登录授权
    • Step 2: Exchange authorization code for tokens
    • 复制 refresh_token
  4. 粘到 FastOpenAI Gmail 配置页

预计耗时: 20-40 分钟, 需要翻墙 + 懂英文 + 懂 OAuth.

凭证存储

Refresh token 加密存 (AES-256-GCM), 服务端用 client_id/secret 换 access token (1h 短期), 不缓存.

下一步

  • (不推荐) 走 OAuth 流程拿 refresh_token
  • 替代: 客服话术 skill + Gmail 网页复制粘贴
  • 联系 wc6895@gmail.com 提需求 (推动 OAuth Connect 一键接入)
相关 AI 技能
这份文档对你有用吗?