TutorialGmailClaudeMCP

如何将 Gmail 连接到 Claude(2 分钟搞定,无需写代码)

通过 MCP 大约两分钟即可将 Gmail 连接到 Claude:一次 Google 登录、一个端点 URL,无需 API 密钥,无需写代码。Claude 实时读取、搜索并发送你的邮件——而你的邮件从不被存储。

如何通过 MCP 在两分钟内将 Gmail 连接到 Claude——一次 Google 登录、一个端点 URL,邮件不被存储

要将 Gmail 连接到 Claude,你只需做两件事:在 MCP Emails 控制台中连接一次你的 Gmail 收件箱,然后把单个端点 URL 粘贴进 Claude 的连接器设置并批准一次登录。这就是全部工作——无需写代码,无需 SDK,无需 API 密钥。大约只要两分钟,而且 Claude 从不存储你的邮件:每一次读取和发送都实时调用 Gmail API,并在 Claude 拿到后立即丢弃。

这是聚焦于 Gmail 的专项教程。如果你管理多个邮箱或使用非 Gmail 的服务商,两分钟内连接任意邮箱指南还涵盖了 Outlook、iCloud、Fastmail 和 IMAP。

你需要准备

  • 一个 Gmail 或 Google Workspace 账户。
  • 一个支持自定义连接器的 Claude 版本——付费方案下的 claude.ai,或 Claude Desktop。(连接器是 Claude 与 MCP 服务器对话的方式。)
  • 一个免费的 MCP Emails 账户。无需信用卡,邮箱与调用次数不限。免费开始,并保持此标签页打开。

MCP Emails 是中间的桥梁:它一侧用 Model Context Protocol 与 Claude 对话,另一侧用 Gmail API 与 Google 对话。如果你想了解这意味着什么的背景知识,请参阅MCP 邮件服务器究竟是什么

第 1 步:连接你的 Gmail 收件箱

在 MCP Emails 控制台中,打开 Inboxes → Connect Inbox → Gmail,点击使用 Google 连接(Connect with Google)

  1. 你会被引导至 Google 的常规登录页。选择你希望 Claude 使用的账户。
  2. 在 Google 的授权页上批准读取和发送权限。
  3. 你会回到控制台,收件箱已连接完成。搞定。

密码从不经手任何一方。MCP Emails 从 Google 接收一个 OAuth 令牌,使用 AES-256-GCM 加密,并在每次请求时直接调用 Gmail API。由于它使用 Gmail 自己的 API,你的智能体在搜索时可以使用 from:is:unreadafter: 等原生运算符——因此 Claude 可以做到精准而非靠猜。

诚实地说明一点:在 MCP Emails 完成 Google 的安全审核之前,授权流程可能会显示一个“Google 尚未验证此应用”的页面。要继续,请点击高级(Advanced),然后点击前往 mcpemails.com(Go to mcpemails.com)。验证完成后此页面将消失。

第 2 步:将 MCP Emails 添加到 Claude

现在把 Claude 指向同一个端点。由于 Claude 是一个 OAuth 客户端,你完全不需要 API 密钥——只需粘贴一个 URL 并批准一次登录。

  1. claude.ai 或 Claude Desktop 中,打开设置 → 连接器(Settings → Connectors)
  2. 点击添加自定义连接器(Add custom connector)
  3. 把以下内容粘贴为连接器 URL,然后点击添加(Add)
https://mcpemails.com/api/mcp
  1. 点击连接(Connect),用你的 MCP Emails 账户登录,并批准你想要的范围——read:emailsend:email,或两者都选。

这就是客户端的全部工作。该连接的范围严格限定于你所批准的内容,你可以在控制台中一键撤销。如果你更想了解 API 密钥的方式(适用于没有内置 OAuth 的客户端,如 Cline 或自定义脚本),请阅读AI 邮件访问中 OAuth 与 API 密钥的对比

第 3 步:向 Claude 发出你的第一条提示

用一个小任务来测试它。让 Claude:

“帮我总结一下我最近三封未读邮件。”

在幕后,Claude 会调用 inbox_list 来发现你已连接的 Gmail,然后调用 email_read 来列出并读取这些邮件。如果它能回答,说明你的连接已经生效。接下来,可以试试:

  • “找出上个月来自 Stripe 的发票,并告诉我金额。”
  • “为我房东的最后一封邮件起草一封礼貌的回复,但先别发送。”
  • “归档我收件箱中本周的所有新闻通讯。”
  • “我在与 Acme 的邮件往来中同意了什么?”

想了解更深入的一整套用法——每日分流、自动摘要和清理例程——请参阅让 Claude 管理收件箱的最佳方式分流与摘要实战手册

Claude 可以用你的 Gmail 做什么

连接完成后,Claude 通过一小套整合工具来工作,因此它能做的远不止读取:

  • 读取与搜索email_read(列出、读取、使用 Gmail 运算符进行全文搜索)。
  • 发送与回复email_compose(发送、回复、转发)——邮件通过 Gmail 以来自你自己地址的普通邮件形式发出,因此你的域名声誉仍然归你所有。
  • 整理email_organize(移动、贴标签、标记、归档)。
  • 草稿、文件夹、定时发送、联系人draftfolderschedulecontact_search 让整套工具更加完整。

有一点要事先说明:MCP Emails 是基于轮询的。没有推送 webhook,所以 Claude 是在你让它检查时才对新邮件作出反应,而不是在邮件抵达的那一刻。对于几乎所有助手类工作流而言,这正是恰到好处的模型。

把 Gmail 连接到 Claude 安全吗?

简短回答:安全,而且整个设计就是围绕这一点构建的。

  • 你的邮件从不被存储。 正文、主题和附件在每次调用时实时获取,交给 Claude,随后立即丢弃。每个收件箱唯一被持久化的,是你那个加密后的 OAuth 令牌。这里讲了为什么“邮件从不被存储”真正重要
  • 范围由你掌控。 只批准只读权限,Claude 就根本无法发送。两者都批准后,你仍可随时撤销其中任意一个。
  • 不共享密码。 Gmail 使用 OAuth,因此 MCP Emails 从不会看到你的 Google 密码,你也可以在 Google 账户设置中断开连接。

完整的威胁模型——哪些内容被加密、攻击者能看到什么、又看不到什么——都在给 AI 智能体邮件访问权限安全吗?中作了说明。

常见问题

把 Gmail 连接到 Claude 需要 API 密钥吗? 不需要。Claude 支持 OAuth,所以你只需粘贴端点 URL 并批准一次登录。API 密钥仅用于没有内置 OAuth 的客户端。

Claude 会存储我的 Gmail 邮件吗? 不会。邮件在每次请求时从 Gmail API 实时获取,并在 Claude 读取后立即丢弃。除了你那个加密的访问令牌外,什么都不保留。

Claude 能从我的 Gmail 发送邮件吗? 可以,前提是你授予了 send:email 范围。发送通过 Gmail API 以来自你自己账户的普通邮件形式进行。如果你更希望 Claude 永不发送,可只授予只读权限。

这在免费版 Claude 方案下能用吗? 自定义连接器需要一个支持它们的 Claude 方案(付费版 claude.ai 或 Claude Desktop)。MCP Emails 这一侧是免费的,无需信用卡。

MCP Emails 会看到我的 Google 密码吗? 不会。Gmail 连接使用 Google OAuth,因此你的密码从不离开 Google。

总结

这就是全部内容:一次 Google 登录、一个端点 URL,Claude 就能读取、搜索并发送你真实的邮件——而且从不存储它们。每个方案在邮箱、调用次数和密钥上都不限量,免费层不收任何费用、也无需信用卡(如果你需要更高的突发限额或 SSO,请查看价格)。

准备好了吗?免费连接你的 Gmail,把端点粘贴进 Claude,让它帮你总结未读邮件。

Asgeir Albretsen
作者
Asgeir Albretsen

Asgeir builds MCPEmails — the bridge that lets AI agents read, search, and send real email over the Model Context Protocol. He writes about agents, email infrastructure, and developer experience.

为你的智能体接入收件箱

几分钟内将 Gmail、Fastmail 或任意 IMAP 账户连接到你的 AI 智能体。