codex-gptpro: call ChatGPT Pro from Codex

日本語 | English

codex-gptpro is a local MCP server that lets Codex ask ChatGPT Web Pro for planning, review, and long-running reasoning, then receive the result back inside Codex.

It is designed for a local, Codex-led workflow. ChatGPT Web does not directly call Codex, and this MCP does not expose arbitrary shell execution, patch application, git commits, git pushes, file deletion, or a remote Codex runner.

Canonical names:

• GitHub repo: codex-gptpro
• package name: codex-gptpro
• MCP server name: codex_gptpro
• Chrome profile: codex-gptpro

---

日本語

これは何か

codex-gptpro は、Codex から ChatGPT Web の Pro 拡張へpromptを送り、回答をCodexへ返すためのローカルMCPサーバーです。

主な用途は、Codexが実装中にChatGPT Proへ重い計画、設計レビュー、調査、長時間の推論を依頼し、その出力をローカルの .ai/pro-outputs に保存して作業に戻すことです。

アーキテクチャ

Codex
  -> MCP server: codex_gptpro
  -> http://127.0.0.1:8788/mcp-codex
  -> run_pro_prompt
  -> Google Chrome profile: codex-gptpro
  -> ChatGPT Web Pro
  <- Pro output saved under .ai/pro-outputs

任意で /mcp もありますが、通常の主経路では使いません。CodexからChatGPT Proを呼び出すだけなら、外部公開やCloudflare Tunnelは不要です。

必要条件

• Node.js 20+
• pnpm
• Google Chrome
• Codex CLI または Codex IDE

Chromiumや専用Chromeアプリのインストールは不要です。既存のGoogle Chromeアプリに、MCP用profile codex-gptpro を作って使います。

セットアップ

git clone https://github.com/tomato-ga/codex-gptpro.git
cd codex-gptpro
pnpm install
pnpm build
pnpm run codex:configure

開発起動:

pnpm dev

本番寄りのローカル起動:

pnpm start

デフォルトURL:

http://127.0.0.1:8788

Codex設定

pnpm run codex:configure は ~/.codex/config.toml に次のMCP設定を追加します。

[mcp_servers.codex_gptpro]
url = "http://127.0.0.1:8788/mcp-codex"
startup_timeout_sec = 20
tool_timeout_sec = 1200
enabled = true
default_tools_approval_mode = "prompt"

MCP_CODEX_TOKEN を設定している場合だけ、次の行も追加されます。

bearer_token_env_var = "MCP_CODEX_TOKEN"

古い [mcp_servers.webgpt] がある場合は、codex:configure が新しい codex_gptpro 設定へ置き換えます。

使い方

Codexでこう依頼します。

Use codex_gptpro MCP.
Register the current repository automatically if needed.
Ask ChatGPT Pro to create an implementation plan for the current task.
Save the output and summarize the next steps.

初回だけChrome profileのログインが必要な場合があります。

Use codex_gptpro MCP.
Call prepare_pro_browser with keepBrowserOpen: true.

開いたChrome profile codex-gptpro でChatGPTにログインしてください。その後、run_pro_prompt が使えます。

主なtool

• register_project: 現在のrepoをMCPへ登録
• list_projects: 登録済みrepoを一覧
• repo_tree: repo構造を安全に取得
• read_file: 許可されたtext fileを読む
• grep_repo: repo内検索
• git_diff: bounded diffを取得
• pro_browser_status: Chrome/Pro連携状態を確認
• prepare_pro_browser: ChatGPTログイン用にChrome profileを開く
• run_pro_prompt: ChatGPT Proへpromptを送り、回答を返す
• list_tasks, read_task, claim_task, write_result, read_result: .ai task handoff
• run_check: typecheck, lint, test, build のallowlisted scriptだけ実行

Chrome profile

デフォルト:

MCP_PRO_CHROME_AUTOMATION_USER_DATA_DIR=~/.codex-gptpro/chrome-user-data
MCP_PRO_CHROME_PROFILE_DIRECTORY=codex-gptpro

これは既存のGoogle Chromeアプリを使います。Chrome 136+では通常のChrome data directoryに対するremote debuggingが制限されるため、MCP専用のuser data dirを使います。

任意の環境変数

.env は必須ではありません。必要な場合だけ作成します。

cp .env.example .env
chmod 600 .env

よく使う値:

MCP_PORT=8788
MCP_CODEX_TOKEN=<long-random-token>
MCP_PUBLIC_PIN=<short-lived-pin>
MCP_PRO_MODEL_LABEL=Pro 拡張
MCP_PRO_CHROME_PROFILE_DIRECTORY=codex-gptpro

セキュリティ

public repoへ入れてはいけないものは .gitignore で除外しています。

• .env, .env.*
• projects.local.json
• .ai/
• .codex/
• node_modules/, dist/, coverage/
• local launchd plist
• Chrome profile data
• local memory files

MCP toolsも意図的に制限しています。

• arbitrary shell executionなし
• patch applicationなし
• file deletionなし
• git commit/pushなし
• direct Codex invocationなし

検証

pnpm build
pnpm test
pnpm lint
pnpm run healthcheck

macOSで常駐化する場合:

pnpm run launchd:install
launchctl print "gui/$(id -u)/local.codex-gptpro"

---

English

What It Does

codex-gptpro is a local MCP server that lets Codex send prompts to ChatGPT Web Pro and receive the answer back in Codex.

The main use case is letting Codex delegate heavyweight planning, design review, research, and long-running reasoning to ChatGPT Pro while keeping implementation and verification local.

Architecture

Codex
  -> MCP server: codex_gptpro
  -> http://127.0.0.1:8788/mcp-codex
  -> run_pro_prompt
  -> Google Chrome profile: codex-gptpro
  -> ChatGPT Web Pro
  <- Pro output saved under .ai/pro-outputs

The optional /mcp endpoint exists for safe planner/reviewer tools, but it is not required for the primary workflow. If all you want is Codex calling ChatGPT Pro, you do not need to expose any endpoint publicly.

Requirements

• Node.js 20+
• pnpm
• Google Chrome
• Codex CLI or Codex IDE

You do not need Chromium or a separate Chrome app. The server uses your existing Google Chrome app with a dedicated Chrome profile named codex-gptpro.

Setup

git clone https://github.com/tomato-ga/codex-gptpro.git
cd codex-gptpro
pnpm install
pnpm build
pnpm run codex:configure

Development server:

pnpm dev

Production-like local server:

pnpm start

Default URL:

http://127.0.0.1:8788

Codex Config

pnpm run codex:configure writes this MCP server block to ~/.codex/config.toml.

[mcp_servers.codex_gptpro]
url = "http://127.0.0.1:8788/mcp-codex"
startup_timeout_sec = 20
tool_timeout_sec = 1200
enabled = true
default_tools_approval_mode = "prompt"

If MCP_CODEX_TOKEN is set, it also adds:

bearer_token_env_var = "MCP_CODEX_TOKEN"

If an old [mcp_servers.webgpt] block exists, codex:configure replaces it with the new codex_gptpro server name.

Usage

Ask Codex:

Use codex_gptpro MCP.
Register the current repository automatically if needed.
Ask ChatGPT Pro to create an implementation plan for the current task.
Save the output and summarize the next steps.

On first use, the Chrome profile may need a ChatGPT login:

Use codex_gptpro MCP.
Call prepare_pro_browser with keepBrowserOpen: true.

Log in to ChatGPT in the opened codex-gptpro Chrome profile. After that, use run_pro_prompt.

Main Tools

• register_project: register the current repository
• list_projects: list registered repositories
• repo_tree: inspect repository structure safely
• read_file: read allowed text files
• grep_repo: search repository text
• git_diff: return bounded diff output
• pro_browser_status: check Chrome/Pro automation status
• prepare_pro_browser: open the Chrome profile for first-run login
• run_pro_prompt: send a prompt to ChatGPT Pro and return the answer
• list_tasks, read_task, claim_task, write_result, read_result: .ai task handoff
• run_check: run only allowlisted package scripts: typecheck, lint, test, build

Chrome Profile

Defaults:

MCP_PRO_CHROME_AUTOMATION_USER_DATA_DIR=~/.codex-gptpro/chrome-user-data
MCP_PRO_CHROME_PROFILE_DIRECTORY=codex-gptpro

This uses your existing Google Chrome app. Chrome 136+ restricts remote debugging on the default Chrome data directory, so this server uses a dedicated user data directory for MCP automation.

Optional Environment Variables

.env is optional. Create one only when needed.

cp .env.example .env
chmod 600 .env

Common values:

MCP_PORT=8788
MCP_CODEX_TOKEN=<long-random-token>
MCP_PUBLIC_PIN=<short-lived-pin>
MCP_PRO_MODEL_LABEL=Pro 拡張
MCP_PRO_CHROME_PROFILE_DIRECTORY=codex-gptpro

Security

Local and sensitive files are ignored by default:

• .env, .env.*
• projects.local.json
• .ai/
• .codex/
• node_modules/, dist/, coverage/
• local launchd plists
• Chrome profile data
• local memory files

The MCP surface is intentionally limited:

• no arbitrary shell execution
• no patch application
• no file deletion
• no git commit/push
• no direct Codex invocation

Verification

pnpm build
pnpm test
pnpm lint
pnpm run healthcheck

For macOS launchd:

pnpm run launchd:install
launchctl print "gui/$(id -u)/local.codex-gptpro"