codex-subagent-mcp
Enables Claude Code to delegate coding tasks—investigation, review, long-running background jobs, and optional file edits—to a locally installed OpenAI Codex CLI, with the model and reasoning effort chosen per task and read-only execution by default. Follow-up requests reuse Codex's existing context, and write-enabled delegations can be confined to a managed git worktree so the user's own checkout stays untouched.
Install
npx -y codex-subagent-mcp
Paste the configuration above into your MCP client config (claude_desktop_config.json for Claude Desktop) and restart the client.
{
"mcpServers": {
"codex-subagent-mcp": {
"command": "npx",
"args": [
"-y",
"codex-subagent-mcp"
],
"env": {
"CODEX_BIN": "<CODEX_BIN>",
"CODEX_SUBAGENT_MAX_EFFORT": "<CODEX_SUBAGENT_MAX_EFFORT>",
"CODEX_SUBAGENT_MAX_SANDBOX": "<CODEX_SUBAGENT_MAX_SANDBOX>",
"CODEX_SUBAGENT_DEFAULT_MODEL": "<CODEX_SUBAGENT_DEFAULT_MODEL>",
"CODEX_SUBAGENT_ALLOWED_MODELS": "<CODEX_SUBAGENT_ALLOWED_MODELS>",
"CODEX_SUBAGENT_DEFAULT_EFFORT": "<CODEX_SUBAGENT_DEFAULT_EFFORT>"
}
}
}
}Paste the configuration above into your MCP client config (claude_desktop_config.json for Claude Desktop) and restart the client.
Sources: public MCP Server directories. This is an independent third-party directory with no affiliation to or endorsement from the maintainers of the listed servers.
