home / mcp / codex dev mcp server

Codex Dev MCP Server

Provides an MCP server to integrate Codex CLI into Claude Code workflows with session management and real-time progress monitoring.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fyzafh-mcp-codex-dev": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-codex-dev"
      ]
    }
  }
}

You can run a Codex-enhanced MCP server locally to manage Codex CLI sessions within Claude Code workflows, monitor progress in real time, and resume work seamlessly across sessions.

How to use

Start the MCP server alongside Claude Code to enable Codex-based tooling. Use an MCP client to connect to the local progress server at http://localhost:23120 for real-time status updates. You can manage sessions, run codex_write to generate code, codex_review for parallel spec and quality checks, and codex_health to diagnose the environment. Sessions are tracked and can be resumed across steps.

How to install

Prerequisites: Codex CLI must be installed and configured before you begin.

{
  "mcpServers": {
    "mcp-codex-dev": {
      "command": "npx",
      "args": ["-y", "mcp-codex-dev"]
    }
  }
}

Or add the MCP server using the Claude CLI helper, which configures the same server for you.

claude mcp add mcp-codex-dev -- npx -y mcp-codex-dev

Windows users can configure the MCP server with the following JSON, or use the PowerShell command shown afterward.

{
  "mcpServers": {
    "mcp-codex-dev": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-codex-dev"]
    }
  }
}

Or install via PowerShell using the same server name.

claude mcp add mcp-codex-dev -- cmd /c npx -y mcp-codex-dev

Configuration

Configure a per-user MCP specification to tailor how Codex tools run and how long they timeout. The global defaults apply to all tools unless overridden in a per-tool section.

A typical per-tool override provides a tighter timeout for heavy operations like code generation or reviews.

Progress Server

A local HTTP server starts at http://localhost:23120 to show real-time progress. You can adjust the port via progressPort if you need to run on a different local port.

License

MIT

Available tools

codex_exec

Clean dialogue without templates and supports session resume.

codex_write

Write code via Codex CLI and supports session resume.

codex_review

Code review combining specification and quality checks in parallel and supports resume.

codex_health

Environment and configuration diagnostics.

codex_session_list

List tracked sessions.

codex_session_discard

Discard sessions.