Skip to content
looot docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Connect Gemini CLI

Add the looot MCP server to Gemini CLI, sign in with the browser or a header token, and check it works.

Gemini CLINot tested by hand yet

MCP over Streamable HTTP at https://api.looot.ai/mcp

Browser sign-in, no token.

Gemini CLI reaches looot’s catalog, balance and runs over MCP, through a config file and an in-CLI auth command.

Before you start you need a looot account. The runs you make spend the organization’s balance, so top up before your first paid run. See Before your first run.

Sign in with the browser

The server URL is https://api.looot.ai/mcp. Nothing to copy: you sign in on looot.ai, pick the organization to bill and click Connect.

Add the server

gemini mcp add --transport http looot https://api.looot.ai/mcp

Or edit ~/.gemini/settings.json

{
  "mcpServers": {
    "looot": {
      "httpUrl": "https://api.looot.ai/mcp"
    }
  }
}

Sign in, inside Gemini CLI

/mcp auth looot

Headless: a token in the header

Only for CI and machines with no browser. Create an agent token in Settings and send it as Authorization: Bearer <token>. Never commit it.

Headless: ~/.gemini/settings.json with a header

{
  "mcpServers": {
    "looot": {
      "httpUrl": "https://api.looot.ai/mcp",
      "headers": {
        "Authorization": "Bearer <agent token from looot.ai Settings>"
      }
    }
  }
}

Notes

  • /mcp list shows looot as connected once you sign in.
  • Labels may differ slightly in your version.

Check it works

Ask Gemini CLI to call balance or catalog_overview. Both are free. A working connection answers with your available balance, or the catalog’s categories and job counts.

Let your AI guide you

Paste this into Claude Code or any AI assistant and it walks you through the setup.

Help me connect the looot MCP server https://api.looot.ai/mcp to Gemini CLI. Go one step at a time and wait for me to confirm. After each step, ask me for a screenshot, check it, and tell me exactly what to do next. Ask me to hide any token first. Check my settings with me as we go. Steps: 1. Run gemini mcp add --transport http looot https://api.looot.ai/mcp. 2. Inside Gemini CLI run /mcp auth looot and sign in. 3. Run /mcp list and check looot is connected. Use browser sign-in. If it fails, tell me to make a token at looot.ai/connect under Advanced and keep it in the config file only, never in this chat. At the end, ask looot for my balance, run ipinfo-lite on 8.8.8.8, and tell me both results.

What you see when you connect

The browser opens looot.ai and shows the consent page: which organization to bill, which scopes to grant and how long to stay connected. See The consent page.

Was this page helpful?