sub agents mcp for Gemini CLI

io.github.shinpr/sub-agents-mcp

MCP server for delegating tasks to specialized AI sub-agents across coding tools

client:Gemini CLI transport:stdio runtime:npm

Install sub agents mcp in Gemini CLI

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

AGENTS_DIR

AGENT_TYPE

AGENT_PERMISSION

AGENT_MODEL

AGENT_EFFORT

CURSOR_API_KEY

CLI_API_KEY

EXECUTION_TIMEOUT_MS

SESSION_ENABLED

SESSION_DIR

SESSION_RETENTION_DAYS

AGENTS_SETTINGS_PATH

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

{
  "mcpServers": {
    "sub-agents-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "sub-agents-mcp"
      ],
      "env": {
        "AGENTS_DIR": "<AGENTS_DIR>",
        "AGENT_TYPE": "<AGENT_TYPE>",
        "AGENT_PERMISSION": "<AGENT_PERMISSION>",
        "AGENT_MODEL": "<AGENT_MODEL>",
        "AGENT_EFFORT": "<AGENT_EFFORT>",
        "CURSOR_API_KEY": "<CURSOR_API_KEY>",
        "CLI_API_KEY": "<CLI_API_KEY>",
        "EXECUTION_TIMEOUT_MS": "<EXECUTION_TIMEOUT_MS>",
        "SESSION_ENABLED": "<SESSION_ENABLED>",
        "SESSION_DIR": "<SESSION_DIR>",
        "SESSION_RETENTION_DAYS": "<SESSION_RETENTION_DAYS>",
        "AGENTS_SETTINGS_PATH": "<AGENTS_SETTINGS_PATH>"
      }
    }
  }
}

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

sub agents mcp in other clients

sub agents mcp MCP server