Content
# 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.
MCP Store
