Skip to content
MCP server

Gemini

Use Google Gemini for images, SVG, video and grounded research inside Claude

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
2.10.1
Listing updated
2 days ago

About Gemini

Gemini is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

This is a third-party server from Houtini that gives Claude access to Google Gemini models through your own Gemini API key. The author uses it to cover things Gemini does well, such as search-grounded research, image generation and video, without leaving the Claude loop.

The README counts 14 tools. Named ones include generate_image, edit_image, generate_video, generate_svg and generate_landing_page. Images use Nano Banana Pro and Nano Banana 2 models, and an image can be generated with search grounding so it reflects real data, such as a weather forecast. Video uses Veo 3.1 with synchronized audio and can start from a first-frame image. SVG output is real vector markup, and the landing page tool returns self-contained HTML from a short brief.

In Claude Desktop, results preview inline through MCP Apps. It installs with a single npx command and needs a Google AI Studio key, and the README flags a free-tier gotcha. It is Apache-2.0 licensed.

Install

Run in a terminal

claude mcp add gemini --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y @houtini/gemini-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "gemini": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@houtini/gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gemini": {
      "command": "npx",
      "args": [
        "-y",
        "@houtini/gemini-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>"
      }
    }
  }
}

Configuration

  • GEMINI_API_KEYGoogle AI Studio API key (get from https://aistudio.google.com/apikey)Required

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

generate_image
Generates images, optionally with search grounding.
edit_image
Edits an existing image from instructions.
generate_video
Generates video, optionally from a first-frame image.
generate_svg
Writes SVG diagrams in technical or data-viz styles.
generate_landing_page
Builds a self-contained HTML landing page from a brief.

What it does

Image generation
Create images, with optional search grounding for real data.
Image editing
Edit a generated file with a one-sentence instruction.
Video generation
Veo 3.1 video with generated audio, optionally from a first frame.
SVG diagrams
Real vector markup in technical or data-viz styles.
Landing pages
Self-contained HTML from a brief, company name and brand color.
Grounded chat and research
Chat and deep research with Google Search grounding.

Good for

  • Generate an infographic that uses current search data
  • Edit a generated image without regenerating it
  • Turn an image into a short video clip
  • Produce an SVG diagram for a repo or page
  • Draft a landing page from a paragraph

Pricing

Open source

Apache-2.0; a Gemini API key is required, and Google's own usage terms apply

Prices change. Check houtini.com before you buy.

Gemini FAQ

What do I need?

A Google AI Studio Gemini API key set as GEMINI_API_KEY.

How many tools does it have?

The README says fourteen.

What license is it under?

Apache-2.0.

How do I install it?

One npx command, or npm i -g @houtini/gemini-mcp.

Is Gemini free?

Yes. Gemini is open source, so you can use and self-host it for free.

How do I add Gemini to Claude Code?

Run this command in your terminal: claude mcp add gemini --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y @houtini/gemini-mcp

What are the best alternatives to Gemini?

The closest alternatives to Gemini are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to Gemini

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media