GoRunner docs
Search or askSearch⌘K

Gemini CLI

Connect Gemini CLI to GoRunner, then ask it to build, run and check your workflows.

3 min · Cloud, Self-hosted and Embed

You need

Gemini CLI
On your computer.

Connect Gemini CLI

  1. In GoRunner, open MCP in the sidebar. If an app is already connected, press Connect an AI app. Choose Gemini CLI; if it isn’t shown, press All 13 apps.
    The Connect an AI app panel with Gemini CLI chosen. The ringed key is the one to press.
  2. In a terminal, run:
    Terminal
    gemini mcp add --transport http gorunner https://api.gorunner.io/mcp/build
  3. In Gemini CLI, run /mcp auth gorunner and sign in.
  4. On Allow “Gemini CLI” to use GoRunner?, choose the workspace and what it may do, then press Allow access.

Since v2026.10.23

  1. In the product you use, open MCP, press Connect an AI app and choose Gemini CLI.
  2. In a terminal, run:
    Terminal
    gemini mcp add --transport http workflows https://YOUR_INSTALLATION/mcp/embed/YOUR_ACCOUNT_ID/build
  3. In Gemini CLI, run /mcp auth workflows and sign in with the account you use here.
  4. Choose what it may do, then press Allow access.

You should see “Connected · Gemini CLI · Acme · 12 tools” in the panel.

It stays connected for up to 180 days, or until you disconnect it.

The address is a placeholder for your account’s own, in the panel. The panel shows your product’s name where these steps say workflows. Without sign-in for AI apps, the panel shows Gemini CLI with a token instead: make or paste one, and copy the command it fills in. If the product lets apps run your workflows but not build them, the address ends in /tools. Gemini CLI can then only call your published workflows. See Turn your workflows into tools.

Can I use an API token instead?

Yes, for an app that can’t sign in. In the panel, press Use an API token instead. Connect with an API token shows each step.

How do I disconnect Gemini CLI?

On the MCP page, under Connected apps, press Disconnect next to the app. Revoke a token in Settings › Workspace › API tokens.

On the product’s MCP page, press Disconnect next to the app.

It stops on its next request. Remove it in Gemini CLI too.

What you can ask

13 tools: it reads, drafts and runs in the workspaces you choose. It publishes only if you allow it.What it can do depends on what the product allows: building, or only your published workflows. If Gemini CLI lists the server’s commands, try one:

  • Build a workflow (when it may write drafts)
  • Diagnose a failed run
  • Explain a workflow

It can also call your own published workflows.

For developers

AI apps connect through MCP (Model Context Protocol). Gemini CLI adds the server https://api.gorunner.io/mcp/build under the name gorunner and signs in with OAuth. Self-hosted: your installation’s address, ending in /mcp/build.