Google Gemini

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from GEMINI_API_KEY is sent as the x-goog-api-key header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
GEMINI_API_KEYYesGemini API key from Google AI Studio (starts with AIza) Docs.

Setup

  1. Sign in to Google AI Studio: Go to https://aistudio.google.com and sign in with a Google account. The free tier works for testing without billing.
  2. Create an API key: Open https://aistudio.google.com/app/apikey and click 'Create API key'. Choose an existing Google Cloud project or let AI Studio create one for you.
  3. Store the key: Copy the key and add it to your .env file as GEMINI_API_KEY=AIza...
  4. Verify access: Run the List Models tool to confirm the key works. A 400 with API_KEY_INVALID means the key is wrong or restricted.

Provider notes

  • This connector uses the Gemini Developer API key (x-goog-api-key header), not Google OAuth - do not use Google Cloud OAuth credentials here
  • Free-tier keys are rate limited; attach a billing-enabled Google Cloud project for higher limits
  • Generation and embedding calls are billed per token on paid tiers

Provider API reference.

Tools

ToolAccessDescription
List Models<br /><code className="reference-identifier">gemini__list_models</code>ReadList models
Get Model<br /><code className="reference-identifier">gemini__get_model</code>ReadGet model
Generate Content<br /><code className="reference-identifier">gemini__generate_content</code>WriteGenerate content
Embed Content<br /><code className="reference-identifier">gemini__embed_content</code>WriteEmbed content
Count Tokens<br /><code className="reference-identifier">gemini__count_tokens</code>ReadCount tokens
Generate Image<br /><code className="reference-identifier">gemini__generate_image</code>WriteGenerate image
Edit Image<br /><code className="reference-identifier">gemini__edit_image</code>WriteEdit image
Generate Image (Imagen)<br /><code className="reference-identifier">gemini__imagen_generate</code>WriteGenerate image (Imagen)
Upload File<br /><code className="reference-identifier">gemini__upload_file</code>WriteUpload temporary file (48-hour retention)
List Files<br /><code className="reference-identifier">gemini__list_files</code>ReadList files
Get File<br /><code className="reference-identifier">gemini__get_file</code>ReadGet file
Delete File<br /><code className="reference-identifier">gemini__delete_file</code>WriteDelete file

Verify the connection

Call a read tool such as gemini__list_models with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.