Codex Subagent MCP Server

Delegate coding tasks to the OpenAI Codex CLI, installed separately, with explicit model and effort.

Local serverstdio

What is the Codex Subagent MCP Server?

Codex Subagent is an MCP integration. Delegate coding tasks to the OpenAI Codex CLI, installed separately, with explicit model and effort.

Packages and local setup

The published npm package is codex-subagent-mcp, version 0.5.0. Its declared MCP transport is stdio.

The package declares CODEX_SUBAGENT_DEFAULT_MODEL: Model used when a call names none; without it the server asks which model to use.; CODEX_SUBAGENT_DEFAULT_EFFORT: Reasoning effort used when a call specifies none.; CODEX_SUBAGENT_ALLOWED_MODELS: Comma-separated allow-list of model slugs; anything else is refused.; CODEX_SUBAGENT_DEFAULT_SANDBOX: Sandbox used when a call specifies none. Defaults to read-only and cannot exceed the ceiling.; CODEX_SUBAGENT_MAX_SANDBOX: Ceiling on what a delegation may do. Defaults to workspace-write; danger-full-access must be set explicitly.; CODEX_SUBAGENT_MAX_EFFORT: Ceiling on reasoning effort.; CODEX_SUBAGENT_MCP_SERVERS: MCP servers from Codex's config a delegation keeps: none (default), all, or comma-separated names.; CODEX_SUBAGENT_PLUGINS: Installed Codex plugins a delegation keeps: none (default), all, or comma-separated name@marketplace ids.; CODEX_SUBAGENT_APPS: Whether a delegation keeps Codex's apps (connectors to external services): off (default) or on.; CODEX_BIN: Path to the Codex executable, if it is not codex on PATH. On Windows it must be codex.exe, not a .cmd shim..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.5.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related ai & ml services MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
CODEX_SUBAGENT_DEFAULT_MODELModel used when a call names none; without it the server asks which model to use.Optional
CODEX_SUBAGENT_DEFAULT_EFFORTReasoning effort used when a call specifies none.Optional
CODEX_SUBAGENT_ALLOWED_MODELSComma-separated allow-list of model slugs; anything else is refused.Optional
CODEX_SUBAGENT_DEFAULT_SANDBOXSandbox used when a call specifies none. Defaults to read-only and cannot exceed the ceiling.Optional
CODEX_SUBAGENT_MAX_SANDBOXCeiling on what a delegation may do. Defaults to workspace-write; danger-full-access must be set explicitly.Optional
CODEX_SUBAGENT_MAX_EFFORTCeiling on reasoning effort.Optional
CODEX_SUBAGENT_MCP_SERVERSMCP servers from Codex's config a delegation keeps: none (default), all, or comma-separated names.Optional
CODEX_SUBAGENT_PLUGINSInstalled Codex plugins a delegation keeps: none (default), all, or comma-separated name@marketplace ids.Optional
CODEX_SUBAGENT_APPSWhether a delegation keeps Codex's apps (connectors to external services): off (default) or on.Optional
CODEX_BINPath to the Codex executable, if it is not codex on PATH. On Windows it must be codex.exe, not a .cmd shim.Optional