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. 89 installs a week from npm. Last commit 20 Oct 2026.

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

Installs per day peak 27 · avg 10 · -5% w/w
a month agotoday
89
Installs / week
npm · codex-mcp-bridge
3
Stars
0 open issues
20 Oct 2026
Last commit
no releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 4 d ago · rules 995398eba69f

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"], {

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": {
      "command": "npx",
      "args": [
        "-y",
        "codex-mcp-bridge"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.codex-mcp-bridge]
command = "npx"
args = ["-y", "codex-mcp-bridge"]
.cursor/mcp.json
{
  "mcpServers": {
    "codex-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "codex-mcp-bridge"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "codex-mcp-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codex-mcp-bridge"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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).

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.

272 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.

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

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

64 installs/wk local only
Codex MCP Go
by w31r4

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

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

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

local only
Codex MCP Tool
by x51xxx

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

95 installs/wk local only
Session Steward
by mallikcheripally

Review and safely clean local Codex and Claude Code sessions

63 installs/wk local only
Search
by dave-london

MCP server for code search (ripgrep + fd) with structured, token-efficient output

121 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 89 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 in the form 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 89 times in the last week. Week over week that is -5%. 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.