Skip to content
Gemini CLI

claude octopus for Gemini CLI

io.github.xiaolai/claude-octopus

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

client:Gemini CLI transport:stdio runtime:npm

Install claude octopus in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "claude-octopus": {
      "command": "npx",
      "args": [
        "-y",
        "claude-octopus"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "CLAUDE_TOOL_NAME": "<CLAUDE_TOOL_NAME>",
        "CLAUDE_MODEL": "<CLAUDE_MODEL>",
        "CLAUDE_PERMISSION_MODE": "<CLAUDE_PERMISSION_MODE>",
        "CLAUDE_ALLOWED_TOOLS": "<CLAUDE_ALLOWED_TOOLS>",
        "CLAUDE_APPEND_PROMPT": "<CLAUDE_APPEND_PROMPT>",
        "CLAUDE_FACTORY_ONLY": "<CLAUDE_FACTORY_ONLY>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

claude octopus in other clients