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. 39 installs a week from npm. Last commit 30 Oct 2026.

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

Installs per day peak 22 · avg 6 · +19% w/w
a month agotoday
39
Installs / week
npm · codex-octopus
20
Stars
0 open issues
30 Oct 2026
Last commit
no 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": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.codex-octopus]
command = "npx"
args = ["-y", "codex-octopus"]
.cursor/mcp.json
{
  "mcpServers": {
    "codex-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "codex-octopus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codex-octopus"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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).

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.

100 installs/wk local only
Toolfactory
by goatinahat

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

180 installs/wk local only
RTFM
by roomi-fields

Local retrieval for AI agents: index code, docs, PDFs, data in SQLite; 24 parsers, served via MCP.

2 107 installs/wk local only
Socraticode
by giancarloerra

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

2 582 installs/wk local only
Graphlens MCP
by neko1313

Semantic code graph MCP server for coding agents

134 installs/wk local only
Agent Lab Deploy
by jinhsueh

Deploy websites, apps, agents and MCP servers from Claude Code or Codex. OAuth, runs in Taiwan.

answering
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

94 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 39 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 in the form 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 39 times in the last week. Week over week that is +19%. 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.