codex-octopus

local MCP server

Installation

Terminal

claude mcp add codex-octopus -e CODEX_API_KEY=... -e CODEX_TOOL_NAME=... -e CODEX_MODEL=... -e CODEX_SANDBOX_MODE=... -e CODEX_APPROVAL_POLICY=... -e CODEX_APPEND_INSTRUCTIONS=... -e CODEX_FACTORY_ONLY=... -- npx -y codex-octopus

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "...",
        "CODEX_TOOL_NAME": "...",
        "CODEX_MODEL": "...",
        "CODEX_SANDBOX_MODE": "...",
        "CODEX_APPROVAL_POLICY": "...",
        "CODEX_APPEND_INSTRUCTIONS": "...",
        "CODEX_FACTORY_ONLY": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

Spawn multiple specialized Codex agents as MCP servers, each independently configured.

Questions

codex-octopus is a local MCP server distributed as the npm package codex-octopus.

Run: claude mcp add codex-octopus -e CODEX_API_KEY=... -e CODEX_TOOL_NAME=... -e CODEX_MODEL=... -e CODEX_SANDBOX_MODE=... -e CODEX_APPROVAL_POLICY=... -e CODEX_APPEND_INSTRUCTIONS=... -e CODEX_FACTORY_ONLY=... -- npx -y codex-octopus

Run: codex mcp add codex-octopus --env CODEX_API_KEY=... --env CODEX_TOOL_NAME=... --env CODEX_MODEL=... --env CODEX_SANDBOX_MODE=... --env CODEX_APPROVAL_POLICY=... --env CODEX_APPEND_INSTRUCTIONS=... --env CODEX_FACTORY_ONLY=... -- npx -y codex-octopus

Similar MCP servers

NameStars

claude-octopusio.github.xiaolai/claude-octopus21
dbxio.github.t8y2/dbx21K
claude-code-organizerio.github.mcpware/claude-code-organizer381
HeyClaude — Claude & AI workflow directoryio.github.JSONbored/heyclaude300
rubber-duckio.github.nesquikm/rubber-duck177
AISIX AI Gatewayio.github.api7/aisix171
mcp-funnelio.github.chris-schra/mcp-funnel156
ncpio.github.portel-dev/ncp100