Multi Mailbox Gmail for Codex

여러 Gmail 및 Google Workspace 계정을 @personal, @work 같은 알아보기 쉬운 별칭으로 연결하고 검색할 수 있는 오픈소스 Codex 플러그인입니다.

Codex를 로컬 MCP 서버와 사서함을 인식하는 지침으로 확장하므로, Search @personal and @work for recent invoices 같은 요청은 선택한 계정을 모두 검색하고 모든 결과마다 출처 사서함을 식별합니다. 메일 접근은 읽기 전용입니다.

릴리스 상태

리포지토리는 공개되어 있지만 현재 개발자 프리— 상태입니다. 공유 OAuth 클라이언트가 추가되기 전까지는, 외부 사용자가 Codex 플러그인을 설치할 수는 있지만, 메일함을 연결하러면 자GGoogle 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만 요청합니다. 리프레시 토큰은 DPAPI로 현재 Windows 사용자에 대해 암호화되며, 별칭과 계정 이메일 주소는 %LOCALAPPDATA%\MultiMailboxGmail의 로컬 메타데이터로 저장됩니다.

현재 설정: 자체 OAuth client 사용하기

자체 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 계정 보안 페이지에서 앱을 별도로 취소할 수도 있습니다.

코드에서 사용 예

• 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. 설치형 앱(installed-app) OAuth 클라이언트 ID를 만들고 게시합니다.

3. 여러 계정으로 end-to-end Codex 연결 흐름을 테스트합니다.

4. 제한된 Gmail 읽기 전용 범위를 Google 공개 앱 검증에 제출합니다.

검토 중에 Google은 검증되지 않은 앱 경고와 미검증 사용자 수 상한을 적용할 수 있습니다. 소스 코드와 자체 클라이언트(BYO) 방식은 계속 사용 가능합니다.

이 프로젝트는 독립 커뮤니티 프로젝트이며 Google 또는 OpenAI에 제휴하거나 보증받지 않았습니다.

이점 참조하세요: 개인정보, 보안, 그리고 Google verification 패키지.