Codex Mcp Bridge

codex-mcp-bridge

Connect Claude, Codex, and Antigravity through MCP. Send work between native Desktop conversations or use independent CLI background workers.

Supports Windows, macOS, and Linux. Native Desktop integration supports Windows and macOS.

https://github.com/user-attachments/assets/98b23989-826f-4d7d-9dcb-ad7dd2739095

Installation

Package — npm

Requires Node.js 22.13+. Use the same command for a fresh install or an update.

Windows PowerShell

macOS / Linux / WSL

Run the command directly in an interactive terminal. It installs the package, applies Claude/Codex/Antigravity settings, and verifies the background relay. Windows installs into %APPDATA%\npm without administrator rights. Existing permissions, project grants, custom settings, and disabled services are preserved.

For native handoffs, sign in to the Desktop apps and open the same saved project in Codex Desktop and Claude Desktop's Code tab. The shared Claude chat connector is a separate local app-server route.

Setup supplies a missing Codex CLI. Install and authenticate Claude Code and agy separately for their workers; CLI authentication is separate from Desktop sign-in.

Windows setup · macOS setup · Project permissions

Independent background workers

Codex ↔ Claude, Codex ↔ Antigravity, and Claude ↔ Antigravity workers communicate through a per-user service, even while Desktop apps are closed or unresponsive. Workers use separate CLI sessions and require an authenticated provider, a running service, and an authorized project.

- MCP tools: worker_status, list_workers, send_to_worker, read_worker_delivery.
- Terminal: worker-relay status, worker-relay list, worker-relay send, worker-relay read.
- Authorize a selected project with bridge-projects allow-project .

On Windows, add .cmd to…