MCP.Market

codex-bridge MCP server

by xallindrome-labs·io.github.xallindrome-labs/codex-bridge·v0.1.0
No reviews yet

Lets Claude Code consult the Codex CLI for plans and images, as durable background jobs.

A91/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A91/100

full report

Adoption
Growing

0 stars256 downloads/wk

Reviews

Write one

Nobody has reviewed codex-bridge yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

codex-bridge tools (5, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • codex_cancelwrite action

    Stop a running Codex job.

  • codex_image

    Ask Codex to generate (or edit) raster images with its image generation tool. Images are saved into `output_dir` as they are made, and their paths returned.

  • codex_plan

    Ask Codex (OpenAI) to act as the planner: produce an implementation plan, review a design, or give a second opinion.

  • codex_result

    Get the status or result of a Codex job (jobs persist across Claude sessions and restarts). With job_id: the result if finished, otherwise progress.

  • codex_resume

    Continue a job that was interrupted (reboot/crash), timed out or failed, from where it stopped: it continues the same Codex thread,

Public scan report

scanner v0.1.10 · 2026-10-25 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 2 days ago15/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 91/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How codex-bridge compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
91/100
higher than 85% of 48,255 servers
Tools
5
the typical server has 7
Tools that change things
20%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
256
more than 79% of 12,191 servers with a package

What its tools let an agent do: 4 read · 1 change

Install codex-bridge in Claude Code, Cursor or VS Code

Runs npx -y @xallindrome-labs/codex-bridge on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add codex-bridge -- npx -y @xallindrome-labs/codex-bridge
Add to Cursor

What the publisher says

From the codex-bridge repository's README, as published. We do not edit it. Read it on GitHub

codex-bridge

Codex jobs for Claude Code that survive crashes, closed windows and reboots, with Codex image generation built in. A dependency-free MCP server built Windows-first: every call is a job saved on disk, so you can close Claude, lose power, or kill a process, and pick the work up again with codex_resume.

Roles: Claude Code implements. Codex plans and builds images.

The server calls in this recording are real (Codex at effort: low, idle time trimmed); the claude mcp add line is scripted. The raw recording is docs/demo.cast; play it with asciinema play docs/demo.cast.

Quickstart

You need Node.js 20 or newer and the Codex CLI installed and logged in.

claude mcp add codex-bridge -- npx -y @xallindrome-labs/codex-bridge

Restart Claude Code, then ask it something like "Get a plan from Codex for adding rate limiting, in the background, and keep going". Claude will call codex_plan with background: true and collect the answer later.

Other MCP clients: run npx -y @xallindrome-labs/codex-bridge as a stdio server.

Platform note: developed and tested on Windows 11, where real Codex jobs have been run. CI checks on Linux, macOS and Windows (Node 20 and 22) that the server starts, speaks MCP and works when installed from the npm tarball, and on Linux and macOS that jobs run, finish and survive the server being killed, using a fake codex. CI has no real Codex CLI, so real Codex jobs on macOS and Linux are untested. Reports and fixes are welcome.

codexplan and codeximage accept:

  • effort: low, medium, high, xhigh, max or ultra (Luna supports up to max).
  • model: overrides the default model for that call.
  • background: true: returns a job_id immediately so Claude can keep working.
  • session_id: continues an earlier Codex thread, for example "make the icon darker".

codex_image also takes count, the number of images wanted. Set it for batches: it enables k/count progress and resumes that ask for exactly the missing images.

How it compares

OpenAI's codex-plugin-cc is the official way to use Codex from Claude Code, and it's good at what it does: slash commands for review and rescue. codex-bridge is an MCP server instead, with a different focus: jobs that don't get lost, and images.

Several open issues in the plugin's tracker are about jobs getting lost, and codex-bridge is designed to avoid each of them. These come from reading the designs, not from a head-to-head test:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

codex-bridge: common questions

Is codex-bridge MCP server safe?
Yes, by our scan: it is graded A (91/100). Read the codex-bridge safety report
How do I install codex-bridge?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does codex-bridge need an API key?
No secret keys are declared. It reads 7 settings from the environment.
Is codex-bridge maintained?
The last commit was 13 days ago (2026-10-22). The latest release is v0.1.0.
How does codex-bridge compare with other MCP servers?
safety score 91/100 (higher than 85% of 48,255 servers); tools 5 (the typical server has 7); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.