# Gemini

> Gemini is an open-source MCP server for ai models and llm tooling. Use Google Gemini for images, SVG, video and grounded research inside Claude. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://houtini.com/gemini-mcp/
- **Repository:** https://github.com/houtini-ai/gemini-mcp
- **MCP Registry name:** io.github.houtini-ai/gemini
- **Categories:** AI models and LLM tooling, design and media
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/gemini-2
