C
Codex Subagent
Delegate coding work to the OpenAI Codex CLI with selectable models, reasoning effort, sandboxing, and background jobs.
Install Codex Subagent
Pick your client, then add it in one click or paste the config.
~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"codex-subagent": {
"command": "npx",
"args": [
"-y",
"codex-subagent-mcp"
]
}
}
}
Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.
Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.
Overview
Use cases
- Delegate repository investigations to a separate coding model
- Run a focused code review with selected reasoning effort
- Diagnose difficult test or race-condition failures
- Start long coding tasks in the background
- Continue a delegated task using its thread context
Key features
- Select Codex models and reasoning effort per task
- Run foreground or background delegations
- Continue work with thread IDs
- Return schema-conforming JSON
- Apply read-only and sandbox boundaries
- Inspect, retrieve, or cancel background jobs
How Codex Subagent works
Tools8
What Codex Subagent lets your agent do. Expand a tool for its parameters.
Security & health
What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.
ActiveLast checked 1d ago
Recent health check succeeded.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 21h ago via OSV.dev · codex-subagent-mcp (npm)
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
Last commit6d agoMost recent push to the default branch.
Tools exposed8Callable tools this server registers over MCP.
Reviews
No reviews yet — be the first to share how it worked for you.
Frequently Asked Questions about Codex Subagent
Codex Subagent is an MCP server that connects an MCP client to the OpenAI Codex CLI installed on the same machine. Its main tools check the CLI, list models, recommend settings, delegate coding tasks, continue threads, and manage background jobs. It lets an orchestrating agent use Codex with selected model and reasoning effort.
Install Node.js 22+, install and sign in to the Codex CLI, ensure it is on PATH, then register the server with `claude mcp add codex-subagent -- npx -y codex-subagent-mcp`. The repository also documents Claude Desktop and other platform-specific installation options.
Yes, Codex Subagent works with Claude Code. Register it using the documented `claude mcp add` command, then use Claude Code to call the delegation and job-management tools. The server is designed so Claude Code remains the orchestrator while the local Codex CLI performs delegated work.
Yes, delegations are read-only by default. Writing requires an explicit `workspace-write` sandbox setting or a user-configured default. The server can also use a managed Git worktree for edits, while sandbox settings and added directories limit where Codex can write.
Related MCP servers
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/codex-subagent)HTML Embed
<a href="https://allmcps.com/mcp/codex-subagent"><img src="https://allmcps.com/api/badge/codex-subagent?style=directory" alt="Codex Subagent on AllMCPs" /></a>