Gemini MCP MCP Server

Integrate search grounded Gemini output into your workflow.

Local serverstdioGo

What is the Gemini MCP MCP server?

Integrate search grounded Gemini output into your workflow. The gemini mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 13 defined tools rather than through you.

What it actually does

I've been running this MCP server in my Claude Desktop setup for months. It's one of the few I leave on permanently — not because Gemini replaces Claude, but because grounded search, image generation, SVG diagrams, and video are things Gemini does genuinely well. Having them as tools inside Claude beats switching browser tabs.

Adding it to your client

@houtini/gemini-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Its toolset

Everything the assistant can do here goes through one of these:

  • gemini_chat — Chat with Gemini 3.1 Pro. Google Search grounding on by default. Supports thinking_level
  • gemini_deep_research — Multi-step iterative research with Google Search. Synthesises comprehensive reports
  • gemini_list_models — Lists available models from the Gemini API
  • gemini_help — Documentation for all features without leaving Claude
  • gemini_prompt_assistant — Expert guidance for image generation with 9 chart design systems
  • generate_image — Image generation with optional search grounding. Full-res saved to disk
  • edit_image — Edit images with natural-language instructions. Multi-turn continuity via thought signatures
  • describe_image — Fast image descriptions using Gemini 3 Flash
  • analyze_image — Structured extraction and analysis using Gemini 3.1 Pro
  • load_image_from_path — Read a local image file and return base64 for any image tool
  • generate_video — Video generation with Veo 3.1 — 4-8 seconds at up to 4K with native audio
  • generate_svg — Production-ready SVG: diagrams, illustrations, icons, data visualisations

Configuration

You will need 2 environment variables: GEMINI_API_KEY, GEMINI_IMAGE_OUTPUT_DIR. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js 18+ - A Gemini API key from Google AI Studio - ffmpeg (optional, for video thumbnail extraction)

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 13 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Gemini MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the gemini mcp mcp server does with a few real requests.

When to reach for it

This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Gemini MCP's toolset — gemini_chat, gemini_deep_research, gemini_list_models and 10 more — is a fair guide to whether it matches your workflow.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
gemini_chatChat with Gemini 3.1 Pro. Google Search grounding on by default. Supports thinking_level
gemini_deep_researchMulti-step iterative research with Google Search. Synthesises comprehensive reports
gemini_list_modelsLists available models from the Gemini API
gemini_helpDocumentation for all features without leaving Claude
gemini_prompt_assistantExpert guidance for image generation with 9 chart design systems
generate_imageImage generation with optional search grounding. Full-res saved to disk
edit_imageEdit images with natural-language instructions. Multi-turn continuity via thought signatures
describe_imageFast image descriptions using Gemini 3 Flash
analyze_imageStructured extraction and analysis using Gemini 3.1 Pro
load_image_from_pathRead a local image file and return base64 for any image tool
generate_videoVideo generation with Veo 3.1 — 4-8 seconds at up to 4K with native audio
generate_svgProduction-ready SVG: diagrams, illustrations, icons, data visualisations
generate_landing_pageSelf-contained HTML landing pages with inline CSS/JS

How to install the Gemini MCP MCP server

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": ["@houtini/gemini-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 18+ - A Gemini API key from Google AI Studio - ffmpeg (optional, for video thumbnail extraction)
VariableDescriptionRequired
GEMINI_API_KEYCredential the server authenticates with.Yes
GEMINI_IMAGE_OUTPUT_DIRFilesystem location the server is allowed to use.Optional

Example prompts to try

  • Use Gemini MCP to gemini chat.
  • Use Gemini MCP to gemini deep research.
  • Use Gemini MCP to gemini list models.

Frequently asked questions

It connects Gemini MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 13 tools (gemini_chat, gemini_deep_research, gemini_list_models, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Gemini MCP directly.