MCPEmailsMCPEmails
登录免费开始使用
Gemini CLI + 邮件

把你的收件箱连接到 Gemini CLI
只需一个设置条目

给 Gemini CLI 一个真实邮箱。在终端中读取、搜索、发送、回复、转发、定时发送和整理邮件，覆盖你已连接的所有收件箱。

在 ~/.gemini/settings.json 的 mcpServers 下添加一个条目，使用 httpUrl 字段，值为 https://mcpemails.com/api/mcp 。首次连接时，CLI 会发现 OAuth 元数据并自行打开浏览器授权流程。

连接你的收件箱阅读文档
1 个收件箱永久免费 自动发现 OAuth 邮件实时获取，从不存储

Gemini CLI 如何连接：OAuth，无需 API 密钥

Gemini CLI 会对本服务器执行标准的 MCP OAuth 流程。它通过 RFC 7591 动态客户端注册 自行注册，所以不需要创建 client ID，并使用 S256 以 授权码加 PKCE 完成授权。整个过程从不传输客户端密钥，令牌也只携带你在我们的授权同意页面上批准的权限范围。它拿到的访问令牌有效期为一小时，并会自动刷新；令牌会以 OAuth: 加客户端名称的形式列在 Dashboard、API Keys 中，你也在那里撤销该连接。

你唯一需要的值

本页的所有内容，都是把这个 URL 填入 Gemini CLI 的方法。

字段值
MCP 服务器 URLhttps://mcpemails.com/api/mcp
传输方式Streamable HTTP (MCP 2025-06-18)
认证OAuth 2.1，带 PKCE 的授权码流程。无需 API 密钥。
设置

如何将 Gemini CLI 连接到你的收件箱

共四步。前两步对所有客户端都一样，其余步骤专门针对这个客户端。

01

创建免费账户并连接邮箱

在 mcpemails.com 注册，无需绑卡，然后前往 Dashboard、Inboxes、Connect Inbox。Outlook 和 Microsoft 365 通过 Microsoft 登录连接；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 需要应用专用密码；其他邮箱都可通过标准 IMAP 与 SMTP 连接。免费版包含 1 个收件箱，永久有效。

02

打开你的 settings.json

编辑 ~/.gemini/settings.json 以作用于所有项目，或编辑某个项目中的 .gemini/settings.json。

03

添加服务器

在 mcpServers 下添加下面的条目。这里用于 Streamable HTTP 服务器的字段是 httpUrl。

04

连接

首次连接时，CLI 会从服务器元数据中自动发现 OAuth 并打开浏览器授权流程。批准你希望 CLI 拥有的权限范围。

~/.gemini/settings.json
{
  "mcpServers": {
    "mcpemails": {
      "httpUrl": "https://mcpemails.com/api/mcp"
    }
  }
}

Gemini CLI 关于远程 MCP 服务器的官方文档： https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md

不确定先连接哪个邮箱？ 查看邮箱服务商兼容性对照表

开始之前

使用 Gemini CLI 时容易踩的坑

httpUrl 和 url 是不同的字段，区别在于传输方式

在 Gemini CLI 设置中，httpUrl 表示 Streamable HTTP 服务器，本服务器正是这种类型。同一对象中的其他键会选择其他传输方式。从 Cursor 指南复制来的片段使用的是 url，在这里无法建立可用的 Streamable HTTP 连接。

零配置靠的是自动发现，而它从一个 401 开始

不需要告诉 CLI 去哪里认证。未经认证的调用会收到一个 401，其 WWW-Authenticate 标头指向我们的受保护资源元数据，其中写明了授权服务器，而授权服务器的元数据又写明了注册、授权和令牌端点。正是这条链路，让你无需创建 client ID，除了 URL 之外也什么都不用粘贴。

共享机器或无图形界面机器上的 CLI 更适合走密钥路线

浏览器授权流程需要浏览器。在构建代理或共享机器上，稳妥的做法是使用一个 bearer API 密钥，其权限范围精确限定为该自动化任务应做的事，并保存在环境变量中，而不是放在会被提交的设置文件里。

值得了解的限制

  • 每个密钥的请求上限为每分钟 100 次、每小时 1,000 次、每天 10,000 次，此外还受你所在套餐的计费操作上限约束。
  • 服务器只做请求与响应。没有 webhook，也没有服务器主动发起的事件，所以新邮件永远不会自己唤醒你的智能体。要对新到的邮件作出反应，请按计划轮询。
  • 每次调用都会从你的邮箱服务商实时获取邮件，从不存储。我们只保存加密后的 OAuth 令牌或应用专用密码，因此令牌一经撤销或邮箱密码一经更改，访问会立即终止。
常见问题

Gemini CLI 与邮件：常见问题解答

如何将邮箱连接到 Gemini CLI？

在 ~/.gemini/settings.json 的 mcpServers 下添加一个条目，将 httpUrl 设为 https://mcpemails.com/api/mcp 。首次连接时，CLI 会从服务器元数据中发现 OAuth 并打开浏览器授权流程。之后它就拥有了读取、搜索、发送、回复、转发、整理和定时发送邮件的工具。

应该用 url 还是 httpUrl？

httpUrl。在 Gemini CLI 设置中，这个键会选择 Streamable HTTP 传输方式，也就是本服务器使用的传输方式。从其他客户端复制 url 条目，是服务器出现在列表中却不提供任何工具的常见原因。

这和 Google 发布的 Gmail MCP 服务器是一回事吗？

不是。Google 发布了一个 Workspace MCP 服务器，在其他服务之外也涵盖 Gmail；如果你只用 Gmail、并且完全在 Google 生态中工作，那是更直接的路径。MCPEmails 面向的是邮箱并非全部来自 Google、并且同一个 URL 还要在 Claude、Cursor 和 ChatGPT 中使用的情况。

Gemini CLI 通过这种方式能访问哪些邮箱？

Outlook.com 和 Microsoft 365 通过 Microsoft 登录（工作账户可能需要 IT 管理员批准一次该应用）；Gmail、iCloud、Fastmail、Yahoo、Zoho 和 Yandex 使用应用专用密码；以及任何在标准端口上支持 IMAP 与 SMTP 的其他邮箱。客户端通过同一个连接看到所有邮箱：你的智能体会先调用 inbox_list 来发现每个已连接的邮箱及其 id，所以不需要在任何地方粘贴 UUID。

Gemini CLI 会在我不知情的情况下发送邮件吗？

只有在你允许的情况下才会。发送受 send:email 权限范围控制，没有该权限的密钥或令牌根本无法发送。此外，收件箱所有者还可以在仪表盘中要求人工审批，届时每一次发送、回复、转发、草稿发送和定时发送都会被暂扣，直到有人放行。

我的邮件会存储在你们的服务器上吗？

不会。每封邮件都是为发起请求的那次调用从你的邮箱服务商实时获取，并直接交给你的客户端。我们只保存加密后的 OAuth 令牌或应用专用密码，以便后续调用能够完成认证。在仪表盘中删除该收件箱，或在邮箱服务商处撤销访问权限，连接会立即终止。

给 Gemini CLI 一个真正的收件箱

一个设置条目，一次登录。1 个收件箱永久免费，无需绑卡。

连接你的收件箱阅读文档