Connect Gemini CLI

Updated 2026-10-17

Use gemini mcp add or edit settings.json. The key for a remote server is httpUrl.

Steps

1. Run the command. The default scope is project; add -s user to use the server everywhere (it is written to ~/.gemini/settings.json).
2. If you edit the file by hand, use httpUrl, not url, for a remote Streamable HTTP server: url is for the older SSE address.

Configuration

gemini mcp add -s user --transport http thefaceanalysis https://mcp.thefaceanalysis.com/mcp

{
  "mcpServers": {
    "thefaceanalysis": {
      "httpUrl": "https://mcp.thefaceanalysis.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "thefaceanalysis": {
      "command": "npx",
      "args": ["-y", "thefaceanalysis-mcp"]
    }
  }
}

Check it works

Ask: “Using The Face Analysis, what is the median fWHR across your 102 reference faces?” The answer should be 1.78.

Source for the Gemini CLI syntax: Gemini CLI: MCP servers. Client menus and file locations change; if a step no longer matches, follow that page and tell us on GitHub.

See also the tool reference and troubleshooting.