Skip to content
MCP server

Codex Octopus

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.1
Listing updated
5 days ago

About Codex Octopus

Codex Octopus is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add codex-octopus --env CODEX_API_KEY='<CODEX_API_KEY>' -- npx -y codex-octopus

Add to claude_desktop_config.json

{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "<CODEX_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "<CODEX_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "codex-octopus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "<CODEX_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "<CODEX_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ],
      "env": {
        "CODEX_API_KEY": "<CODEX_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CODEX_API_KEYOpenAI API key (leave unset to inherit from parent process)
  • CODEX_TOOL_NAMETool name prefix (default: codex)
  • CODEX_MODELModel: gpt-5-codex, o3, codex-1, or full ID
  • CODEX_SANDBOX_MODESandbox: read-only, workspace-write, danger-full-access
  • CODEX_APPROVAL_POLICYApproval: never, on-failure, on-request, untrusted
  • CODEX_APPEND_INSTRUCTIONSAdditional instructions appended to the default
  • CODEX_FACTORY_ONLYSet to true to expose only the factory wizard tool

Pricing

Open source

Codex Octopus FAQ

Is Codex Octopus free?

Yes. Codex Octopus is open source, so you can use and self-host it for free.

How do I add Codex Octopus to Claude Code?

Run this command in your terminal: claude mcp add codex-octopus --env CODEX_API_KEY='<CODEX_API_KEY>' -- npx -y codex-octopus

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers