Gemini CLI

The Gemini CLI configures MCP servers in its settings.json — ~/.gemini/settings.json for all projects, or .gemini/settings.json inside a project. Servers live under the mcpServers key.

Local (stdio)

Use command + args:

{
    "mcpServers": {
        "oi-docs": {
            "command": "php",
            "args": [
                "/absolute/path/to/OiDevDocs/artisan",
                "mcp:start",
                "documentation"
            ]
        }
    }
}

Remote (HTTP)

Gemini CLI uses httpUrl for streamable-HTTP servers:

{
    "mcpServers": {
        "oi-docs": {
            "httpUrl": "https://dev.olacombe.com/mcp/documentation"
        }
    }
}

Add a headers object alongside httpUrl if your deployment requires an Authorization token.

Verify

Start the CLI and run the /mcp command to list servers and confirm oi-docs is connected with its tools discovered. See the overview for the reference values used above.