codex-bridge MCP Server

What the code does

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

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

  fs.rmSync(path.join(jobDir(job.id), 'cancel'), { force: true });

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 r = spawnSync(isWin ? 'where.exe' : 'which', [name], { encoding: 'utf8', windowsHide: true });

    path.join(CODEX_HOME, 'plugins', '.plugin-appserver', exe),

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

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.

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

{
  "mcpServers": {
    "codex-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@xallindrome-labs/codex-bridge"
      ]
    }
  }
}

[mcp_servers.codex-bridge]
command = "npx"
args = ["-y", "@xallindrome-labs/codex-bridge"]

{
  "mcpServers": {
    "codex-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@xallindrome-labs/codex-bridge"
      ]
    }
  }
}

{
  "servers": {
    "codex-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xallindrome-labs/codex-bridge"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: CODEX_BIN (Path to the Codex CLI binary. Auto-detected when unset), CODEX_BRIDGE_HOME (Where job files are stored. Default: ~/.codex-bridge), CODEX_BRIDGE_IDLE_TIMEOUT_MS (Stop a run after this many ms with no Codex output. Default: 600000), CODEX_BRIDGE_PLAN_MODEL (Model for codex_plan. Default: your Codex config), CODEX_BRIDGE_PLAN_EFFORT (Reasoning effort for codex_plan. Default: your Codex config), CODEX_BRIDGE_IMAGE_MODEL (Model for codex_image. Default: gpt-6-luna), CODEX_BRIDGE_IMAGE_EFFORT (Reasoning effort for codex_image. Default: high).