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.

@mcpemails

为你的智能体接入收件箱

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