Codex Mcp Bridge

Name: Codex Mcp Bridge
Author: hampsterx

by hampsterxcommunityv0.5.1

An MCP server that wraps the Codex CLI as a subprocess and exposes tools for code execution, agentic code review, web search, structured JSON output, and session-based conversations. It adds concurrency control, model fallback, and environment isolation around Codex CLI usage.

From the registry: Wraps Codex CLI as MCP tools: query, review, search, assess, structured, sessions.

GitHub Repository

Install & configure

Prerequisites

required
Install Codex CLI
Install the OpenAI Codex CLI, which this MCP bridge wraps as a subprocess.
```
$ npm i -g @openai/codex
```
https://github.com/openai/codex/
required
Authenticate Codex CLI
Set the OPENAI_API_KEY environment variable or complete Codex CLI login with `codex auth login` so the underlying Codex CLI can authenticate.
```
$ codex auth login
```
https://github.com/openai/codex/

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `codex-mcp-bridge` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install Codex CLI** — Install the OpenAI Codex CLI, which this MCP bridge wraps as a subprocess. Run: `npm i -g @openai/codex` (https://github.com/openai/codex/)
- **Authenticate Codex CLI** — Set the OPENAI_API_KEY environment variable or complete Codex CLI login with `codex auth login` so the underlying Codex CLI can authenticate. Run: `codex auth login` (https://github.com/openai/codex/)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","codex-mcp-bridge"]
- optional environment variables:
  - `OPENAI_API_KEY`: OpenAI API key for Codex CLI authentication. Required if you have not already authenticated via `codex auth login`. (example: `<your-openai-api-key>`)
  - `CODEX_DEFAULT_MODEL`: Default model for all tools. (example: `<your-default-model>`)
  - `CODEX_FALLBACK_MODEL`: Fallback model used on quota exhaustion. Set to `none` to disable fallback. (example: `<your-fallback-model>`)
  - `CODEX_CLI_PATH`: Path to the Codex CLI binary. (example: `<path-to-codex-cli>`)
  - `CODEX_MAX_CONCURRENT`: Maximum concurrent Codex subprocess spawns. (example: `<max-concurrent-spawns>`)
  - `CODEX_MCP_SERVERS`: Controls which Codex internal MCP servers stay enabled. (example: `<your-codex-mcp-servers-setting>`)

Note: The README’s recommended portable install path is `npx -y codex-mcp-bridge`. This is a stdio MCP server. The server depends on a separately installed Codex CLI (`codex` by default, or override with `CODEX_CLI_PATH`).

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: The README’s recommended portable install path is `npx -y codex-mcp-bridge`. This is a stdio MCP server. The server depends on a separately installed Codex CLI (`codex` by default, or override with `CODEX_CLI_PATH`).

Tools (7)

codex

Execute prompts with file context, sandbox control, and multi-turn session resume.

review

Perform agentic code review on diffs or uncommitted changes, with a quick diff-only mode.

Run web search via Codex CLI and return synthesized answers with source URLs.

query

Run lightweight text analysis in an isolated temp directory without repo context.

structured

Generate JSON Schema-validated structured output using Ajv.

ping

Check CLI version, auth status, capabilities, and concurrency diagnostics.

listSessions

List active conversation sessions with metadata such as turn count, model, and timestamps.

Environment variables

OPENAI_API_KEYrequiredAuthenticates Codex CLI access.

Packages

codex-mcp-bridge

npmv0.5.1transport: stdio

Details

Language: TypeScript
License: MIT
Released: Apr 20, 2026
Last commit: Apr 28, 2026
Registry name: io.github.hampsterx/codex-mcp-bridge

Related Servers

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

66.0k

Codebase Memory Mcp

Persistent codebase knowledge graph. Survives session restarts and context compaction.

35.4k

Serena

A powerful toolkit for coding, providing semantic retrieval and editing capabilities.

26.9k