# gemini

Adds Gemini tools for image generation and editing, video, SVG, chat, and Google Search-grounded research. Use it to run these tasks from your coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 34
- Author: houtini-ai
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/houtini-ai/gemini-mcp
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/gemini

## What it does

This MCP server connects Gemini models to an agent. Its tools include image generation and editing, video creation with Veo 3.1, SVG and HTML page generation, chat, and deep research grounded in Google Search. In Claude Desktop, results can appear inline through MCP Apps.

You need a Gemini API key and `npx` to run it. The setup command passes the key as `GEMINI_API_KEY`. Check the model costs: some defaults for chat, landing pages, and image analysis are paid, so requests using those models can fail with a free key unless you select a free model.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GEMINI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add gemini -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @houtini/gemini-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add gemini --env GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @houtini/gemini-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gemini": {
            "command": "npx",
            "args": [
                "-y",
                "@houtini/gemini-mcp"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gemini": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@houtini/gemini-mcp"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> gemini npx -y @houtini/gemini-mcp
```
Replace <…> with your own values

## When to use it
- generate an image from a prompt
- edit an image with text instructions
- create a video from a starting frame
- produce an SVG diagram for a project
- research a topic using Google Search

## Example prompts
- Generate an image from this description and use Google Search for current facts.
- Edit this image: change the scene to daylight and alter the details’ color.
- Create an SVG diagram of this service’s architecture.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md