Spawn multiple specialized Codex agents as MCP servers, each independently configured.
Connect Runs on your machine
claude mcp add codex-octopus -e CODEX_API_KEY=<CODEX_API_KEY> -e CODEX_TOOL_NAME=<CODEX_TOOL_NAME> -e CODEX_MODEL=<CODEX_MODEL> -e CODEX_SANDBOX_MODE=<CODEX_SANDBOX_MODE> -e CODEX_APPROVAL_POLICY=<CODEX_APPROVAL_POLICY> -e CODEX_APPEND_INSTRUCTIONS=<CODEX_APPEND_INSTRUCTIONS> -e CODEX_FACTORY_ONLY=<CODEX_FACTORY_ONLY> -- npx -y [email protected]{
"mcpServers": {
"codex-octopus": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CODEX_API_KEY": "<CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<CODEX_TOOL_NAME>",
"CODEX_MODEL": "<CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<CODEX_FACTORY_ONLY>"
}
}
}
}{
"mcpServers": {
"codex-octopus": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CODEX_API_KEY": "<CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<CODEX_TOOL_NAME>",
"CODEX_MODEL": "<CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<CODEX_FACTORY_ONLY>"
}
}
}
}{
"servers": {
"codex-octopus": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"CODEX_API_KEY": "<CODEX_API_KEY>",
"CODEX_TOOL_NAME": "<CODEX_TOOL_NAME>",
"CODEX_MODEL": "<CODEX_MODEL>",
"CODEX_SANDBOX_MODE": "<CODEX_SANDBOX_MODE>",
"CODEX_APPROVAL_POLICY": "<CODEX_APPROVAL_POLICY>",
"CODEX_APPEND_INSTRUCTIONS": "<CODEX_APPEND_INSTRUCTIONS>",
"CODEX_FACTORY_ONLY": "<CODEX_FACTORY_ONLY>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
CODEX_API_KEYOptional, secret | OpenAI API key (leave unset to inherit from parent process) |
CODEX_TOOL_NAMEOptional | Tool name prefix (default: codex) |
CODEX_MODELOptional | Model: gpt-5-codex, o3, codex-1, or full ID |
CODEX_SANDBOX_MODEOptional | Sandbox: read-only, workspace-write, danger-full-access |
CODEX_APPROVAL_POLICYOptional | Approval: never, on-failure, on-request, untrusted |
CODEX_APPEND_INSTRUCTIONSOptional | Additional instructions appended to the default |
CODEX_FACTORY_ONLYOptional | Set to true to expose only the factory wizard tool |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 2 Apr 2026 |
| Last updated | 2 Apr 2026 |
| Registry name | io.github.xiaolai/codex-octopus |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.