Codex Subagent MCP Server

What the code does

We read the source, 2 d ago · rules ccca72095570

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

        execFile(file, args, options, (error) => callback(error));

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add codex-subagent-mcp -- npx -y codex-subagent-mcp

{
  "mcpServers": {
    "codex-subagent-mcp": {
      "args": [
        "-y",
        "codex-subagent-mcp"
      ],
      "command": "npx"
    }
  }
}

[mcp_servers.codex-subagent-mcp]
command = "npx"
args = ["-y", "codex-subagent-mcp"]

{
  "mcpServers": {
    "codex-subagent-mcp": {
      "args": [
        "-y",
        "codex-subagent-mcp"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "codex-subagent-mcp": {
      "args": [
        "-y",
        "codex-subagent-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: 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.). The author declared them in the registry entry; get the values from the project itself.