
Codex Mcp Tool
Bridges Claude to the OpenAI Codex CLI for code analysis using file references like @src/ or @package.json. Exposes ask-codex for queries with model selection (gpt-5.5, gpt-5.4, gpt-5.3-codex), session management for multi-turn conversations, and brainstorm for SCAMPER ideation frameworks. Supports sandbox mode for safe execution, web search for research tasks, and local OSS models via Ollama or LM Studio. The list-sessions tool manages conversation state, while health diagnoses CLI version and feature compatibility. Reach for this when you want Claude to leverage Codex's specialized coding models without leaving your workflow, especially for refactoring sessions or when you need structured OLD/NEW patch output.
- GitHub stars
- 21
- tools
- 14
- transport
- STDIO
- env vars
- 3
- last updated
- Mar 13, 2026
Tools
14 toolsPublic tool metadata for what this MCP can expose to an agent.
ask-codexExecute Codex CLI with files, models, sessions, and safety controls
Execute Codex CLI with files, models, sessions, and safety controls
No parameter schema in public metadata yet.
batch-codexRun multiple atomic Codex tasks sequentially or concurrently
Run multiple atomic Codex tasks sequentially or concurrently
No parameter schema in public metadata yet.
review-changesRun the native non-interactive Codex review command
Run the native non-interactive Codex review command
No parameter schema in public metadata yet.
do-actExecute, verify with a shell command, and retry fixes
Execute, verify with a shell command, and retry fixes
No parameter schema in public metadata yet.
image-genGenerate or edit images with Codex's built-in image_gen tool
Generate or edit images with Codex's built-in image_gen tool
No parameter schema in public metadata yet.
brainstormGenerate ideas with structured creative frameworks
Generate ideas with structured creative frameworks
No parameter schema in public metadata yet.
list-sessionsView, delete, or clear MCP conversation mappings
View, delete, or clear MCP conversation mappings
No parameter schema in public metadata yet.
list-skillsList skills visible from the selected workspace
List skills visible from the selected workspace
No parameter schema in public metadata yet.
healthDiagnose CLI installation, version, features, and sessions
Diagnose CLI installation, version, features, and sessions
No parameter schema in public metadata yet.
fetch-chunkRetrieve a chunk from cached change-mode output
Retrieve a chunk from cached change-mode output
No parameter schema in public metadata yet.
pingTest the MCP connection
Test the MCP connection
No parameter schema in public metadata yet.
helpReturn current codex --help output
Return current codex --help output
No parameter schema in public metadata yet.
versionReport Codex CLI, Node.js, platform, and package versions
Report Codex CLI, Node.js, platform, and package versions
No parameter schema in public metadata yet.
timeout-testExercise keepalive and timeout behavior
Exercise keepalive and timeout behavior
No parameter schema in public metadata yet.
Sponsors
Configuration
CODEX_MCP_CWDOverride working directory for all tool calls
CODEX_SESSION_TTL_MSSession time-to-live in milliseconds (default: 86400000 = 24h)
CODEX_MAX_SESSIONSMaximum concurrent sessions (default: 50)
Readme
Codex MCP Server
MCP server connecting Claude/Cursor to Codex CLI. Enables code analysis via @ file references, multi-turn conversations, sandboxed edits, and structured change mode.
Features
Details
- Repository
- github.com/x51xxx/codex-mcp-tool
- Category
- AI & LLM Tools
- Package
@trishchuk/codex-mcp-tool- Transport
- STDIO
- Registry
- MCP registry, active