mcpbeat Sign in

Codex Octopus MCP Server

local only

Codex Octopus runs on your own machine — the client starts it, so there is no endpoint to ping. 45 installs a week from npm. Last commit 18 Sep 2026.

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

Installs per day peak 21 · avg 7 · -52% w/w
a month agotoday
45
Installs / week
npm · codex-octopus
20
Stars
0 open issues
18 Sep 2026
Last commit
0 releases in 90 days
ISC
License
TypeScript

Nothing serious here today

Today is the operative word: we check Codex Octopus every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add codex-octopus -- npx -y codex-octopus
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "codex-octopus": {
      "args": [
        "-y",
        "codex-octopus"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.codex-octopus]
command = "npx"
args = ["-y", "codex-octopus"]
.cursor/mcp.json
{
  "mcpServers": {
    "codex-octopus": {
      "args": [
        "-y",
        "codex-octopus"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "codex-octopus": {
      "args": [
        "-y",
        "codex-octopus"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: CODEX_API_KEY (OpenAI API key (leave unset to inherit from parent process)), CODEX_TOOL_NAME (Tool name prefix (default: codex)), CODEX_MODEL (Model: gpt-5-codex, o3, codex-1, or full ID), CODEX_SANDBOX_MODE (Sandbox: read-only, workspace-write, danger-full-access), CODEX_APPROVAL_POLICY (Approval: never, on-failure, on-request, untrusted), CODEX_APPEND_INSTRUCTIONS (Additional instructions appended to the default), CODEX_FACTORY_ONLY (Set to true to expose only the factory wizard tool). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Codex Octopus

same job, measured the same way
Claude Octopus
by xiaolai

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

81 installs/wk local only
Toolfactory
by goatinahat

Build an agent tool once; ship it as Agent Skills, MCP servers, Agent Plugins / Claude / Codex

640 installs/wk local only
Socraticode
by giancarloerra

MCP server for enterprise local codebase indexing, semantic search, and code dependency graphs.

5 182 installs/wk local only
Graphlens MCP
by neko1313

Semantic code graph MCP server for coding agents

162 installs/wk local only
Automatised Pipeline
by cdeust

Codebase intelligence MCP server — index any repo into a property graph; 26 tools for agents.

local only
Deepcontext
by wild-card

Advanced codebase indexing and semantic search MCP server

121 installs/wk local only
Agentmako
by drhalto

Local-first codebase intelligence MCP server for AI coding agents.

53 installs/wk local only
Briefroom
by briefroom

briefroom stdio MCP server — expose the briefroom CLI to Claude Code, Codex, and other agents.

45 installs/wk local only

Codex Octopus — questions

Answers built from our own checks of this server.

Why is there no uptime for Codex Octopus?
Codex Octopus runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package codex-octopus was installed 45 times last week.
How do I connect Codex Octopus?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls codex-octopus straight from npm; nothing to host, nothing to sign up for.
How many people use Codex Octopus?
The npm package codex-octopus was installed 45 times in the last week. Week over week that is -52%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Codex Octopus open source?
Yes — it is published under the ISC licence, written in TypeScript and 20 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.