Developer · Local MCP server

Codex Octopus

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

What the MCP Registry states

The entry as published to the official MCP Registry (read 2026-10-04), latest version.

Registry name
io.github.xiaolai/codex-octopus
Version
1.0.1
Status
Active
Category
developer
Transport
stdio (local process)
Package
npm
Published
2026-04-02
Updated
2026-04-02
Publisher
xiaolai (GitHub) · 2 servers with pages here
Repository
github.com/xiaolai/codex-octopus
Source
Registry API entry

Packages

RegistryPackageVersionTransportEnvironment variables
npmcodex-octopus1.0.1stdioCODEX_API_KEY (secret), CODEX_TOOL_NAME, CODEX_MODEL, CODEX_SANDBOX_MODE, CODEX_APPROVAL_POLICY, CODEX_APPEND_INSTRUCTIONS, CODEX_FACTORY_ONLY

How to connect Codex Octopus

Codex Octopus runs locally from a Node.js package published to the npm registry: codex-octopus version 1.0.1. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Node.js; clients usually start it with npx — the usual command is npx -y codex-octopus@1.0.1. It reads these environment variables: CODEX_API_KEY (secret), CODEX_TOOL_NAME, CODEX_MODEL, CODEX_SANDBOX_MODE, CODEX_APPROVAL_POLICY, CODEX_APPEND_INSTRUCTIONS and CODEX_FACTORY_ONLY; set them in the client's configuration for this server.

In the mcpServers JSON format that many desktop and editor MCP clients read, the entry looks like this (placeholders in angle brackets):

{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus@1.0.1"
      ],
      "env": {
        "CODEX_API_KEY": "<secret>",
        "CODEX_TOOL_NAME": "<value>",
        "CODEX_MODEL": "<value>",
        "CODEX_SANDBOX_MODE": "<value>",
        "CODEX_APPROVAL_POLICY": "<value>",
        "CODEX_APPEND_INSTRUCTIONS": "<value>",
        "CODEX_FACTORY_ONLY": "<value>"
      }
    }
  }
}

Derived from the registry entry, not tested here. What the server does, and on what terms, is set by its publisher; check its repository or website before giving it access to your accounts or files. How to add an MCP server to an assistant · Before you connect

More from xiaolai (GitHub)

ServerRunsEndpoint or package
Claude OctopusSpawn multiple specialized Claude Code agents as MCP servers, each independently configured.Local · stdionpm: claude-octopus

More developer servers

All 6,250 →
ServerRunsEndpoint or package
Codex DelegateBridge AI coding hosts to the OpenAI Codex CLI for delegated implementation.Local · stdionpm: codex-delegate-mcp
Codex MCP BridgeWraps Codex CLI as MCP tools: codex, review, query, search, structured, ping, listSessions.Local · stdionpm: codex-mcp-bridge
Codex MCP GoMCP server wrapping Codex CLI for stdio-based tool calls.Local · stdionpm: @zenfun510/codex-mcp-go
Codex MCP ToolMCP server bridging AI assistants to OpenAI Codex CLI for code analysis and review.Local · stdionpm: @trishchuk/codex-mcp-tool
Codex ServerOps MCPStateful Windows OpenSSH server operations for Codex with local credential handling.Local · stdioPyPI: codex-serverops-mcp
Codex SubagentDelegate coding tasks to the OpenAI Codex CLI, installed separately, with explicit model and effort.Local · stdionpm: codex-subagent-mcp
Codex Tldraw MCPA Codex stdio MCP server that generates repo-local tldraw diagrams and detects code graph drift.Local · stdionpm: codex-tldraw-mcp
CodexaCodex-native codebase intelligence context compiler and query-only MCP server.Local · stdionpm: @mirnoorata/codexa