codex-as-mcp

# codex-as-mcp [中文版](./README.zh-CN.md) **Spawn multiple subagents via Codex-as-MCP** Each subagent runs `codex e --full-auto` with complete autonomy inside the MCP server's current working directory. Perfect for Plus/Pro/Team subscribers leveraging GPT-5 capabilities. **Use it in Claude Code** There are two tools in codex-as-mcp  You can spawn parallel codex subagents using prompt.  Here's a sample Codex session delegating two tasks in parallel.  ## Setup ### 1. Install Codex CLI **Requires Codex CLI >= 0.46.0** ```bash npm install -g @openai/codex@latest codex login # Verify installation codex --version ``` ### 2. Configure MCP Add to your `.mcp.json`: ```json { "mcpServers": { "codex-subagent": { "type": "stdio", "command": "uvx", "args": ["codex-as-mcp@latest"] } } } ``` Or use Claude Desktop commands: ```bash claude mcp add codex-subagent -- uvx codex-as-mcp@latest ``` If you're configuring Codex CLI directly (for example `~/.config/codex/config.toml`), add: ```toml [mcp_servers.subagents] command = "uvx" args = ["codex-as-mcp@latest"] ``` ## Tools - `spawn_agent(prompt: str)` – Spawns an autonomous Codex subagent using the server's working directory and returns the agent's final message. - `spawn_agents_parallel(agents: list[dict])` – Spawns multiple Codex subagents in parallel; each item must include a `prompt` key and results include either an `output` or an `error` per agent.