Gemini CLI¶

Connect Open Referral to Gemini CLI. The most reliable path today uses a personal Open Referral token via an HTTP header (it bypasses Gemini CLI's OAuth auto-discovery).

Info

🚧 Screenshots coming soon.

Prerequisites¶

Connect Open Referral¶

Open your Gemini CLI config file: ~/.gemini/settings.json.
Add Open Referral under mcpServers:

{
  "mcpServers": {
    "open-referral": {
      "httpUrl": "https://mcp.openreferral.io",
      "headers": {
        "Authorization": "Bearer ${OPEN_REFERRAL_TOKEN}"
      }
    }
  }
}

Put your token in the OPEN_REFERRAL_TOKEN environment variable (do not paste it directly in the file).
Restart Gemini CLI and run /mcp list — open-referral should show as connected.

Try it¶

Troubleshooting¶

Cannot perform dynamic registration without issuer — this is Gemini CLI's OAuth auto-discovery failing. Use the Bearer-token method above instead of /mcp auth.