# gemini-mcp

Wires Gemini 3 models into Claude: image and video generation, web search, code analysis and Python execution.

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

## What it does

The server hands your agent more than thirty Gemini tools. Image generation goes up to 4K across ten aspect ratios, and you can keep refining a picture turn by turn in one session. There is video through Veo, text-to-speech with 30 voices, YouTube analysis by URL with timestamp clipping, PDF and spreadsheet parsing with table extraction, grounded web search with source links, and JSON output validated against a schema. A separate `gemini-run-code` tool has Gemini write and run Python — numpy, pandas, matplotlib, scipy, scikit-learn and tensorflow are supported. Charts land in the output directory and come back as images.

Two tools are built for working alongside Claude. `gemini-brainstorm` takes your own take on a problem and runs several rounds of back-and-forth with Gemini, while `gemini-analyze-code` reviews code for quality, security, performance or bugs. Reasoning depth is set per call with `thinkingLevel`, from minimal to high. Token counting and cost estimates run before the API call, so you can see what a request costs first. Video generation is asynchronous — poll it with the check tool.

None of this starts without a `GEMINI_API_KEY`, which you get from Google AI Studio and pass at registration. Set `GEMINI_OUTPUT_DIR` too if you want generated images and videos somewhere predictable instead of the default folder. The package also installs globally and ships a `gcli` CLI, where the key is stored in its config.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GEMINI_API_KEY`, `GEMINI_OUTPUT_DIR` — 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 --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GEMINI_OUTPUT_DIR=<GEMINI_OUTPUT_DIR> --transport stdio gemini-mcp -- npx -y @rlabs-inc/gemini-mcp
```
Replace <…> with your own values

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- generate a 4K image without leaving the agent
- create a Veo video and poll until it is ready
- pull tables and text out of a PDF or spreadsheet
- ground an answer in fresh web results with citations
- get a second opinion on code security and bugs

## Example prompts
- Generate a cyberpunk city at sunset, 16:9, 2K
- Analyze this file for vulnerabilities and suggest fixes
- Calculate the first 50 primes and plot them

## Similar
- [scenario-gemini-omni](https://affpapa.org/en/nevibecode/skills/scenario-gemini-omni.md) — skill · 378 installs
- [baoyu-danger-gemini-web](https://affpapa.org/en/nevibecode/skills/baoyu-danger-gemini-web.md) — skill · 27900 installs
- [scenario-gemini-image](https://affpapa.org/en/nevibecode/skills/scenario-gemini-image.md) — skill · 392 installs
- [anycap-gemini-omni-video-edit](https://affpapa.org/en/nevibecode/skills/anycap-gemini-omni-video-edit.md) — skill · 444 installs
- [ai-multimodal](https://affpapa.org/en/nevibecode/skills/ai-multimodal.md) — skill · 530 installs
- [videoagent-image-studio](https://affpapa.org/en/nevibecode/skills/videoagent-image-studio.md) — skill · 5600 installs

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