mcp-codex-dev
MCP Server for integrating Codex CLI into Claude Code workflows with session management and real-time progress monitoring.
Installation
Prerequisites: Codex CLI installed and configured.
In .mcp.json file
{
"mcpServers": {
"mcp-codex-dev": {
"command": "npx",
"args": ["-y", "mcp-codex-dev"]
}
}
}
or
claude mcp add mcp-codex-dev -- npx -y mcp-codex-dev
Windows OS:
{
"mcpServers": {
"mcp-codex-dev": {
"command": "cmd",
"args": ["/c", "npx", "-y", "mcp-codex-dev"]
}
}
}
or
claude mcp add mcp-codex-dev -- cmd /c npx -y mcp-codex-dev
Tools
| Tool | Description |
|---|---|
codex_exec |
Clean dialogue without templates, supports session resume |
codex_write |
Write code via Codex CLI, supports session resume |
codex_review |
Code review (spec + quality in parallel), supports resume |
codex_health |
Environment and config diagnostics |
codex_session_list |
List tracked sessions |
codex_session_discard |
Discard sessions |
Configuration
Create ~/.mcp/mcp-codex-dev/config.json:
{
"model": "gpt-5.2",
"sandbox": "danger-full-access",
"timeout": 300000,
"tools": {
"codex_write": {
"model": "gpt-5.3-codex",
"sandbox": "danger-full-access",
"timeout": 2000000
},
"codex_review": {
"model": "gpt-5.2",
"sandbox": "danger-full-access",
"timeout": 3000000
},
"codex_health": { "enabled": false }
}
}
Top-level model / sandbox / timeout are global defaults. The tools section overrides per tool (keyed by tool name). Set "enabled": false to disable a tool.
Per-project config can be placed at <project>/.mcp/mcp-codex-dev.config.json.
Progress Server
A local HTTP server starts at http://localhost:23120 showing real-time progress. Configurable via progressPort.
License
MIT
