Back to search
mcp-codex-dev
SkillWorks with CodexGitHub
MCP Server for Codex CLI integration - stateful code writing and review workflows
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/fyzafh--mcp-codex-dev)HTML
<a href="/listings/fyzafh--mcp-codex-dev"><img src="/api/listings/fyzafh--mcp-codex-dev/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Prerequisites: [Codex CLI](https://github.com/openai/codex) 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
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 97 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # mcp-codex-dev
- <p align="center">English | <a href="README.zh-CN.md">中文</a></p>
- MCP Server for integrating [Codex CLI](https://github.com/openai/codex) into Claude Code workflows with session management and real-time progress monitoring.
- <img width="1890" height="948" alt="image" src="https://github.com/user-attachments/assets/490a8cf6-1267-42cd-8f6f-e0a82c0dc6a3" />
- ## Installation
- Prerequisites: [Codex CLI](https://github.com/openai/codex) installed and configured.
- In .mcp.json file
- ```
- {
- "mcpServers": {
- "mcp-codex-dev": {
- "command": "npx",
- "args": ["-y", "mcp-codex-dev"]
- }
- }
- }
- ```
- or
- ```bash
- 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
- ```powershell
- claude mcp add mcp-codex-dev -- cmd /c npx -y mcp-codex-dev
- ```
- ## Tools
- | Tool | Description |
- |------|-------------|
- |`exec`|Clean dialogue without templates, supports session resume|
- |`tdd`|Codex CLI with built-in test-driven development prompt template|
- | `review` | Code review (spec + quality in parallel), supports resume |
- | `health` | Environment and config diagnostics |
- | `session_list` | List tracked sessions |
- | `session_discard` | Discard sessions |
- ## Configuration
- Create `~/.mcp/mcp-codex-dev/config.json`:
- ```json
- {
- "model": "gpt-5.2",
- "sandbox": "danger-full-access",
- "timeout": 300000,
- "tools": {
- "tdd": { "model": "gpt-5.3-codex", "sandbox": "danger-full-access", "timeout": 2000000},
- "review": { "model": "gpt-5.2", "sandbox": "danger-full-access", "timeout": 3000000},
- "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`.
- When multiple MCP server instances run simultaneously, they share a single progress page: the first instance binds the port and serves the UI, and other instances forward their progress events to it.
- ## Session Tracking
- Session tracking metadata is stored per project at `<project>/.mcp/mcp-codex-dev/sessions.json` (where `<project>` is the Git repo root if applicable).
- Codex CLI's own session files remain in `~/.codex/sessions/<id>/`.
- ## License
- No license.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.