Multi Mailbox Gmail for Codex

一个开源 Codex 插件，用于按 @personal、@work 这样的友好别名连接和搜索多个 Gmail 与 Google Workspace 账户。

它通过本地 MCP 服务器和识别邮箱的指令来扩展 Codex，因此像 Search @personal and @work for recent invoices 这样的请求会同时搜索所选账户，并为每条结果标识来源邮箱。邮件访问是只读的。

发布状态

该仓库是公开的，但目前仍是开发者预览版。在共享 OAuth 客户端加入之前，外部用户可以安装该 Codex 插件，但必须先提供自己的 Google 桌面 OAuth 凭据，才能连接邮箱。

Related MCP server: multi-gmail-mcp-server

在 Codex 中安装

npx codex-marketplace add pkforge/multi-mailbox-gmail --plugin

安装完成后启动一个新的 Codex 任务，以便加载插件的技能和 MCP 工具。

在聊天中连接邮箱

共享公共 OAuth 客户端上线后，用户将启动一个新的 Codex 任务并输入：

Connect @personal
Connect @work

每条命令都会打开 Google 的账户选择器。选择应拥有该别名的账户，并批准只读 Gmail 访问。根据需要重复此操作以连接更多账户。

计划中的公共版本将使用一个共享的 Google 桌面应用身份，因此最终用户不需要 Google Cloud 账户或开发者设置。OAuth 直接在此本地插件与 Google 之间进行：没有发布者后端、数据库、分析或遥测。该插件仅请求 https://www.googleapis.com/auth/gmail.readonly。刷新令牌使用 DPAPI 加密，仅限当前 Windows 用户可用；别名和账户邮箱地址作为本地元数据存储在 %LOCALAPPDATA%\MultiMailboxGmail 下。

当前设置：使用你自己的 OAuth 客户端

希望使用自有 Google Cloud 项目的组织可以创建桌面 OAuth 客户端，启用 Gmail API，然后将下载的 JSON 传给 CLI，或设置 MULTI_MAILBOX_GMAIL_OAUTH_CLIENT_FILE。

npm.cmd install
npm.cmd run mailbox -- add personal C:\path\to\oauth-client.json
npm.cmd run mailbox -- add work C:\path\to\oauth-client.json
npm.cmd run mailbox -- list

每条 add 命令都会打开 Google 登录。选择应拥有该别名的账户。

移除本地存储的凭据：

npm.cmd run mailbox -- remove work

此操作会删除本地加密的令牌。如有需要，您还可以在 Google 账户安全页面单独撤销该应用的授权。

在聊天中使用

• Search @personal and @work for invoices from the last 90 days.

• Search @finance for unread mail with attachments.

• Search all mailboxes for subject:renewal newer_than:1y.

该插件在返回每条消息时都会带式标注来源别名，因此即使存在相同文本的消息，也能正确归因到相应的邮箱。

公开发布前的剩余工作

在非开发者无需 Google Cloud 设置即可使用 Connect @alias 之前，项目所有者必须：

1. 完成 Google OAuth 同意屏幕配置。

2. 创建并发布已安装应用 OAuth 客户端身份。

3. 使用多个账户测试 Codex 端到端连接流程。

4. 将受限的 Gmail 只读范围提交 Google 公共应用验证。

在验证过程中，Google 可能会显示“未经验证的应用”警告，并施加未验证用户上限。源代码和自带客户端的方案仍可继续使用。

这是一个独立的社区项目，与 Google 或 OpenAI 没有关联或背书关系。

参见 Privacy、Security 和 Google verification package。# Multi Mailbox Gmail for Codex

一个开源 Codex 插件，通过 @personal、@work 这类友好别名连接和搜索多个 Gmail 与 Google Workspace 账户。

它通过本地 MCP 服务器和识邮箱的指令来扩展 Codex，因此，像Search @personal and search @work for recent invoices 这样的请求会会搜索所选账户，并标注每条结果的来源邮箱。邮件访问是只读的。

发布状态

该仓库是公开的，但当前仍为开发者预览版。在共享 OAuth 客户端加入之时，外部用户可以安装该 Codex 插件，但必须在连接邮箱之前提供自己的 Google 桌面 OAuth 凭据。

在 Codex 中安装

npx codex-marketplace add pkforge/multi-mailbox-gmail --plugin

安装完成后启动新的 Codex 任务，这样插件的技能和 MCP 工具就会加载。

在聊天中连接邮箱

一旦共享公共 OAuth 客户端上线，用户将启动一个新的 Codex 任务，并说：

Connect @personal
Connect @work

每条命令都会打开 Google 的账户选择器。选择应拥有该别名的账户，并授予只读 Gmail 访问权限。按需要为多个账户重复此操作。

计划中的公共版本将使用一个共享的 Google 桌面身份，因此最终用户不需要 Google Cloud 账户或进行开发者设置。OAuth 在此本地插件与 Google 之间直接内进行：没有发布者后端、数据库、分析或遥测。该插件仅请求 https://www.googleapis.com/auth/gmail.readonly。刷新令牌使用 DPAPI 为当前 Windows 用户加密；别名和账户电子邮件地址作为本地元数据存储在 %LOCALAPPDATA%\MultiMailboxGmail 下。

当前设置：使用你自己的 OAuth 客户端

倾向于使用自己 Google Cloud 项目的组织，可以创建桌面 OAuth 客户端、启用 Gmail API，然后将其下载的 JSON 传给 CLI，或设置 MULTI_MAILBOX_GMAIL_OAUTH_CLIENT_FILE。

npm.cmd install
npm.cmd run mailbox -- add personal C:\path\to\oauth-client.json
npm.cmd run mailbox -- add work C:\path\to\oauth-client.json
npm.cmd run mailbox -- list

每条 add 命令都会打开 Google 登录。选择应拥有该别名的账户。

移除本地存储的凭据：

npm.cmd run mailbox -- remove work

这会移除本地加密的令牌。如有需要，还可以单独在 Google 账户安全页面上撤销该应用的授权。

在聊天中使用

• Search @personal and @work for invoices from the last 90 days.

• Search @finance for unread mail with attachments.

• Search all mailboxes for subject:renewable newer_than:1y.

该插件会连同来源别名一起返回每条消息，因此各邮箱中相同的消息仍能被正确归属。

公开发布前的剩余工作

在非开发者能够无需 Google Cloud 设置即可使用 Connect @alias 之前，项目所有者必须：

1. 完成 Google OAuth 同意屏幕配置。

2. 创建并发布已安装应用 OAuth 客户端身份。

3. 使用多个账户测试 end-to-end Codex 连接流。

4. 将受限类 Gmail 只读范围提交 Google 进行公开应用验证。

在验证期间，Google 可能会显示未验证应用警告，并执行其未验证用户上限。源代码和自带告警库的路径仍然可用。

这是一个独立社区项目，与 Google 或 OpenAI 无关或未获其认可。

另见 Privacy、Security 和 Google verification package。