Multi Mailbox Gmail for Codex

Открытый плагин Codex для подключения и поиска по нескольким аккаунтам Gmail и Google Workspace с помощью удобных псевдонимов, например @personal и @work.

Он расширяет Codex локальным MCP-сервером и инструкциями, учитывающими почтовые ящики, поэтому запрос вроде Search @personal and @work for recent invoices ищет в обоих выбранных аккаунтах и указывает исходный почтовый ящик для каждого результата. Доступ к почте — только на чтение.

Статус релиза

Репозиторий публичен, но сейчас это превью для разработчиков. Пока не добавлен общий OAuth-клиент, сторонний пользователь может установить плагин Codex, но должен предоставить собственные учётные данные Google Desktop 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 Desktop app, поэтому конечным пользователям не потребуется аккаунт Google Cloud или настройка разработчика. OAuth выполняется напрямую между этим локальным плагином и Google: нет издательского бэкенда, базы данных, аналитики или телеметрии. Плагин запрашивает только https://www.googleapis.com/auth/gmail.readonly. Refresh-токены шифруются для текущего пользователя Windows с помощью DPAPI; псевдонимы и адреса электронной почты аккаунтов хранятся как локальные метаданные в каталоге %LOCALAPPDATA%\MultiMailboxGmail.

Текущая настройка: используйте собственный OAuth-клиент

Организации, предпочитающие собственный проект Google Cloud, могут создать Desktop 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 Account.

Использование в чате

• 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.

Плагин возвращает каждое сообщение с указанием исходного псевдонима, поэтому одинаковые сообщения остаются привязанными к правильному почтовому ящи.

Остающиеся задачи перед публичным релизом

Прежде чем люди, не являющиеся разработчиками, смогут использовать подключние Connect @alias без настройки Google Cloud, владелец проекта должен:

1. Завершить конфигурацию экрана согласия Google OAuth.

2. Создать и опубликовать OAuth-клиент для установленного приложения.

3. Протестировать процесс полного подключения Codex с несколькими аккаунтами.

4. Отправить ограниченный Gmail read-only scope на проверку Google для публичного приложения.

Во время проверки Google может показать предупреждение о непроверенном приложжении и применять лимит для непроверенных пользователей. Исходный код и путь конфигурации с собственным клиентом остаются рабочими.

Это независимый проект сообщества, not аффилированный with Google or OpenAI and no endorsed by them.

См. Конфиденциальность, Безопасность и пакет верификации Google.