Setup guide - Documented by Goose
Use Gemini in Goose
goose has a built-in Google Gemini provider configured through goose configure (CLI) or Settings > Models (Desktop) using GOOGLE_API_KEY.
Last verified 4 steps2 official sources
Steps
- Step 1.
Get an API key from Google AI Studio (https://aistudio.google.com/app/apikey).
- Step 2.
goose Desktop: Open the sidebar, click Settings, click the Models tab, click Configure Providers, choose Google Gemini as provider from the list, click Configure, enter your API key, and click Submit.
- Step 3.
goose CLI: run goose configure, select Configure Providers, choose Google Gemini, enter your API key when prompted, then enter the Gemini model of your choice.
Terminalgoose configure - Step 4.
Optional: for Gemini 3 models, set the thinking level. Precedence: request_params.thinking_level in model configuration, then the GEMINI3_THINKING_LEVEL environment variable, then the default value low.
Caveats
- goose's sample CLI transcript enters model gemini-2.0-flash-exp, which is outdated (Google lists Gemini 2.0 Flash as Shut down). Enter a current id from Google's models page instead.
- Gemini 3 thinking levels in goose are Low (default) and High.
More setup guides
Same tool, other providers
Related reading
- Do Your Agent Hooks Fail Open? Claude Code vs Codex vs Cursor vs Gemini CLIA guard hook that crashes, times out or points at a missing script lets the tool call through by default in Claude Code. v2.1.295 adds onFailure: block. Here is what each coding agent does when your policy hook breaks, with real test runs.
- Google AI Pro vs Gemini API: What Developers Actually GetGoogle AI Pro costs $19.99 a month and has no API key, but includes $10 of monthly Cloud credits. When the subscription wins and when to pay per token.
- How to Keep API Keys Away From Your AI Coding Agent: Claude Code vs Codex vs Cursor vs Gemini CLIA deny rule on .env stops cat but not a Python one-liner. Here are the three layers that actually keep secrets out of a coding agent's context - file rules, environment scrubbing and credential masking - and what Claude Code, Codex, Cursor and Gemini CLI give you for each, with real test runs.
- Google Gemini Agent: Coworker Agents With Their Own EmailGoogle's Gemini agent can create coworker agents with their own Workspace account, email and audit trail. What Google announced and what builders should copy.
- Gemini 4 Argon: What Developers Can Actually UseGemini 4 Argon for developers: what Google shipped, what is verified, why access starts narrow, and what to watch before planning a migration around it.
- Gemini 3.8 Live and 3.8 Live Extended Thinking: Google's Audio-to-Audio Voice Models, Benchmarked and PricedGemini 3.8 Live and 3.8 Live Extended Thinking are Google's audio-to-audio voice models with background tool calls. Benchmarks, pricing and how to build.
FAQ
How do I use Gemini in Goose?
goose has a built-in Google Gemini provider configured through goose configure (CLI) or Settings > Models (Desktop) using GOOGLE_API_KEY.
Which Gemini model ids work in Goose?
The official docs read for this guide list gemini-4-argon, gemini-3.8-flash, gemini-3.6-flash, gemini-3.5-flash-lite, gemini-3.1-pro-preview, gemini-2.5-pro and gemini-2.5-flash.
Is this an official Gemini and Goose setup?
Goose documents this setup in its own docs. It was last checked against 2 official pages on October 17, 2026.
Sources
Last verified against 2 official pages.
- raw.githubusercontent.comhttps://raw.githubusercontent.com/block/goose/main/documentation/docs/getting-started/providers.md
- ai.google.devhttps://ai.google.dev/gemini-api/docs/models
Newsletter
New models, set up the day they ship
One email per week. New model releases, the coding tools that support them and how to wire them up.