Codex Dev
An MCP server that integrates Codex CLI into Claude Code workflows for code writing, execution, and review with session management. It features real-time progress monitoring via a local HTTP dashboard and supports detailed configuration for various c
What is Codex Dev?
Codex Dev is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that integrates codex cli into claude code workflows for code writing, execution, and review with session management. it features real-time progress monitoring via a local http dashboard an...
An MCP server that integrates Codex CLI into Claude Code workflows for code writing, execution, and review with session management. It features real-time progress monitoring via a local HTTP dashboard and supports detailed configuration for various c
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server that integrates Codex CLI into Claude Code wor
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-codex-devConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Codex Dev
mcp-codex-dev is a TypeScript MCP server that integrates OpenAI Codex CLI into Claude Code workflows, providing tools for code writing, test-driven development, parallel code review, and session management with persistent state per project. It runs a local HTTP dashboard on port 23120 for real-time progress monitoring and supports per-project and per-tool configuration, making it easy to track long-running Codex tasks from within your AI assistant. Developers who use Claude Code alongside Codex CLI use this server to orchestrate code generation, TDD cycles, and code reviews without leaving the Claude interface.
Prerequisites
- Node.js 18 or newer installed
- OpenAI Codex CLI installed and configured with a valid API key (the Codex CLI must work independently before using this server)
- Claude Code CLI installed for the recommended setup path
- An MCP-capable client: Claude Code (primary), or any client supporting stdio MCP servers
Verify Codex CLI is installed and working
Before setting up mcp-codex-dev, confirm that the Codex CLI is installed and can authenticate with OpenAI. The MCP server delegates to Codex CLI, so this is a hard dependency.
codex --version
# Should print a version number without errorsAdd mcp-codex-dev to Claude Code
Register the server with Claude Code using the mcp add command. This is the recommended installation path.
claude mcp add mcp-codex-dev -- npx -y mcp-codex-dev
# On Windows:
# claude mcp add mcp-codex-dev -- cmd /c npx -y mcp-codex-devOr add to .mcp.json manually
Add the server to your project's .mcp.json configuration file for project-scoped use.
{
"mcpServers": {
"mcp-codex-dev": {
"command": "npx",
"args": ["-y", "mcp-codex-dev"]
}
}
}Configure per-project settings (optional)
Create a project-level config file to customize the model, sandbox mode, timeout, and progress monitoring port.
# Create <project>/.mcp/mcp-codex-dev.config.json
{
"model": "gpt-5.2",
"sandbox": "danger-full-access",
"timeout": 120000,
"progressPort": 23120
}Monitor task progress in the web dashboard
While a Codex task is running, open the local progress dashboard in your browser to track real-time output.
# Open in browser while a task is running:
http://localhost:23120Codex Dev Examples
Client configuration (Claude Desktop)
Configure Claude Desktop to use the mcp-codex-dev server for Codex CLI integration.
{
"mcpServers": {
"mcp-codex-dev": {
"command": "npx",
"args": ["-y", "mcp-codex-dev"]
}
}
}Prompts to try
These prompts use the exec, tdd, review, and session management tools exposed by mcp-codex-dev.
- "Use Codex to implement a binary search function in TypeScript with tests"
- "Run a TDD cycle: write failing tests for a user authentication module, then implement the code"
- "Review the current diff for correctness and code quality issues in parallel"
- "List all active Codex sessions for this project"
- "Check the health of the Codex CLI environment"Troubleshooting Codex Dev
Server starts but Codex tasks fail immediately
The Codex CLI must be independently installed and authenticated. Run 'codex --version' and a simple 'codex' command manually to confirm it works. If the CLI itself fails, fix that before using mcp-codex-dev.
Progress dashboard at localhost:23120 shows no output
The dashboard only shows active tasks. If no Codex task is currently running, the page will be empty. Start a task via the exec or tdd tools and then refresh the dashboard. Change progressPort in the config if port 23120 is in use.
Session state is not persisting between Claude Code restarts
Sessions are stored at <project>/.mcp/mcp-codex-dev/sessions.json. Ensure the project directory is writable and that you are running Claude Code from the same project root each time. Use the session_list tool to verify existing sessions.
Frequently Asked Questions about Codex Dev
What is Codex Dev?
Codex Dev is a Model Context Protocol (MCP) server that mcp server that integrates codex cli into claude code workflows for code writing, execution, and review with session management. it features real-time progress monitoring via a local http dashboard and supports detailed configuration for various c It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Codex Dev?
Follow the installation instructions on the Codex Dev GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Codex Dev?
Codex Dev works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Codex Dev free to use?
Yes, Codex Dev is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Codex Dev Alternatives — Similar Developer Tools Servers
Looking for alternatives to Codex Dev? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Codex Dev in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Codex Dev?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.