mcpbeat Sign in

Codex MCP Bridge MCP Server

local only

Codex MCP Bridge runs on your own machine — the client starts it, so there is no endpoint to ping. 55 installs a week from npm. Last commit 29 Aug 2026.

Wraps Codex CLI as MCP tools: codex, review, query, search, structured, ping, listSessions.

Installs per day peak 275 · avg 31 · +608% w/w
a month agotoday
55
Installs / week
npm · codex-mcp-bridge
3
Stars
0 open issues
29 Aug 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 19 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    const output = execFileSync(binary, ["--version"], {
  for (const [key, value] of Object.entries(process.env)) {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add codex-mcp-bridge -- npx -y codex-mcp-bridge
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "codex-mcp-bridge": {
      "args": [
        "-y",
        "codex-mcp-bridge"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.codex-mcp-bridge]
command = "npx"
args = ["-y", "codex-mcp-bridge"]
.cursor/mcp.json
{
  "mcpServers": {
    "codex-mcp-bridge": {
      "args": [
        "-y",
        "codex-mcp-bridge"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "codex-mcp-bridge": {
      "args": [
        "-y",
        "codex-mcp-bridge"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: CODEX_CLI_PATH (Path to the codex CLI binary. Defaults to 'codex' on PATH.), CODEX_DEFAULT_MODEL (Default Codex model for codex/query/search.), CODEX_FALLBACK_MODEL (Model to use when the primary model hits a quota error.), CODEX_MAX_CONCURRENT (Maximum concurrent Codex CLI subprocesses (default 3).), CODEX_MCP_SERVERS (Controls which MCP servers from ~/.codex/config.toml stay enabled inside the Codex subprocess. Empty/unset disables all non-required servers; 'inherit' passes config through; comma-separated names (e.g. 'serena,github') enables those; values starting with '{' or '[' are raw TOML.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Codex MCP Bridge

same job, measured the same way
Claude MCP Bridge
by hampsterx

Wraps Claude Code CLI as MCP tools: query, search, structured, ping, listSessions.

116 installs/wk local only
Grok Build
by nuruvala

Run the Grok Build CLI as MCP tools: agent runs with live progress, code review, web research.

126 installs/wk local only
MCP Code Review Server
by goodjobwilliam

Code review as an MCP server — structured reviews with OWASP security scanning.

122 installs/wk local only
Codex MCP Go
by w31r4

MCP server wrapping Codex CLI for stdio-based tool calls.

60 installs/wk local only
Pare Search
by dave-london

Pare Search ג€” Structured code search operations (ripgrep + fd) as typed JSON.

local only
showagent
by aytzey

Search, resume and convert AI coding sessions (Claude Code, Codex, Gemini, OpenCode, Pi) over MCP.

local only
Codex MCP Tool
by x51xxx

MCP server bridging AI assistants to OpenAI Codex CLI for code analysis and review

151 installs/wk local only
Session Steward
by mallikcheripally

Review and safely clean local Codex and Claude Code sessions

562 installs/wk local only

Codex MCP Bridge — questions

Answers built from our own checks of this server.

Why is there no uptime for Codex MCP Bridge?
Codex MCP Bridge runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package codex-mcp-bridge was installed 55 times last week.
How do I connect Codex MCP Bridge?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls codex-mcp-bridge straight from npm; nothing to host, nothing to sign up for.
How many people use Codex MCP Bridge?
The npm package codex-mcp-bridge was installed 55 times in the last week. Week over week that is +608%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Codex MCP Bridge open source?
Yes — it is published under the MIT licence, written in TypeScript and 3 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.