io.github.xiaolai/claude-octopusai

claude-octopus

Verified · today

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

Install

claude mcp add claude-octopus -- npx -y [email protected]

Requires: ANTHROPIC_API_KEY, CLAUDE_TOOL_NAME, CLAUDE_MODEL, CLAUDE_PERMISSION_MODE, CLAUDE_ALLOWED_TOOLS, CLAUDE_APPEND_PROMPT, CLAUDE_FACTORY_ONLY

Our take

Spawns multiple independently-configured Claude Code agents as MCP tools — each arm gets its own model, permission mode, and tool allowlist, with a factory wizard for defining new specialists. Built on the official Claude Agent SDK by Li Xiaolai, a well-known author with a long GitHub history, and the code is clean with no install tricks. Note the CLAUDE_PERMISSION_MODE env can be set to bypassPermissions, so configure the arms as carefully as you would a root shell. Registry metadata lags npm by a version.

reviewed by hand · 2026-07-06

Something wrong or dead here? Report it

Verification record

last verified: today
github stars: 15
last commit: 19 days ago
archived: no
license: ISC
npm: claude-octopus
downloads / wk: 179
latest version: 1.2.0
in registry since: 2026-05-20

github.com/xiaolai/claude-octopus