Gemini Mcp

by RLabs-Inc

508 downloads

Not rated

GitHub

About

MCP Server that enables Claude code to interact with Gemini

Details

Author: RLabs-Inc
Downloads: 508
Categories: Developer Tools, AI, Other

- Deep research agent with web search and citations
- 4K image generation with 10 aspect ratios
- Multi-turn image editing through conversation
- Video generation using Veo 2.0 (async polling)
- Code execution with Python libraries (numpy, pandas, matplotlib)
- Real-time web search with inline citations

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Gemini Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

From the repository

Install via npm (@rlabs-inc/gemini-mcp) and add it to Claude Code with claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY npx -y @rlabs-inc/gemini-mcp. Alternatively, install globally (npm install -g @rlabs-inc/gemini-mcp) and use the gcli CLI. Set your API key once with gcli config set api-key YOUR_KEY and then invoke any tool (e.g., gcli image, gcli search) directly from the terminal.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gemini mcp": {
            "gemini-mcp": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

McpServers

{
    "gemini-mcp": {
        "command": "bun",
        "args": [
            "run",
            "build"
        ]
    }
}

MCP Server Gemini

A Model Context Protocol (MCP) server for integrating Google's Gemini 3 models with Claude Code, enabling powerful collaboration between both AI systems. Now with a beautiful CLI!

MCP Registry Support: Now discoverable in the official MCP ecosystem!

Features

| Feature | Description | |-------------------------------|-----------------------------------------------------------------| | Deep Research Agent | Autonomous multi-step research with web search and citations | | Token Counting | Count tokens and estimate costs before API calls | | Text-to-Speech | 30 unique voices, single speaker or two-speaker dialogues | | URL Analysis | Analyze, compare, and extract data from web pages | | Context Caching | Cache large documents for efficient repeated queries | | YouTube Analysis | Analyze videos by URL with timestamp clipping | | Document Analysis | PDFs, DOCX, spreadsheets with table extraction | | 4K Image Generation | Generate images up to 4K with 10 aspect ratios | | Multi-Turn Image Editing | Iteratively refine images through conversation | | Video Generation | Create videos with Veo 2.0 (async with polling) | | Code Execution | Gemini writes and runs Python code (pandas, numpy, matplotlib) | | Google Search | Real-time web information with inline citations | | Structured Output | JSON responses with schema validation | | Data Extraction | Extract entities, facts, sentiment from text | | Thinking Levels | Control reasoning depth (minimal/low/medium/high) | | Direct Query | Send prompts to Gemini 3 Pro/Flash models | | Brainstorming | Claude + Gemini collaborative problem-solving | | Code Analysis | Analyze code for quality, security, performance | | Summarization | Summarize content at different detail levels | ---

Quick Installation

MCP Server for Claude Code

bash
Using npm (Recommended)

claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY npx -y @rlabs-inc/gemini-mcp

Using bun

claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY bunx @rlabs-inc/gemini-mcp



CLI (Global Install)

bash
Install globally

npm install -g @rlabs-inc/gemini-mcp

Set your API key once (stored securely)

gcli config set api-key YOUR_KEY

Now use any command!

gcli search "latest news"
glci image "sunset over mountains" --ratio 16:9



Get your API key: Visit Google AI Studio - it's free and takes seconds!

Installation Options

bash
With verbose logging

claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY VERBOSE=true bunx -y @rlabs-inc/gemini-mcp

With custom output directory for generated images/videos

claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY GEMINI_OUTPUT_DIR=/path/to/output bunx -y @rlabs-inc/gemini-mcp



---

Available Tools


gemini-query


Direct queries to Gemini with thinking level control:


prompt: "Explain quantum entanglement"
model: "pro" or "flash"
thinkingLevel: "low" | "medium" | "high" (optional)



- low: Fast responses, minimal reasoning
- medium: Balanced (Flash only)
- high: Deep reasoning for complex tasks (default)

gemini-generate-image


Generate images with Nano Banana Pro (Claude can SEE them!):


prompt: "a futuristic city at sunset"
style: "cyberpunk" (optional)
aspectRatio: "16:9" (1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9)
imageSize: "2K" (1K, 2K, 4K)
useGoogleSearch: false (ground in real-world info)



gemini-start-image-edit


Start a multi-turn image editing session:


prompt: "a cozy cabin in the mountains"
aspectRatio: "16:9"
imageSize: "2K"
useGoogleSearch: false



Returns a session ID for iterative editing.

gemini-continue-image-edit


Continue refining an image:


sessionId: "edit-123456789"
prompt: "add snow on the roof and make it nighttime"



gemini-end-image-edit


Close an editing session:


sessionId: "edit-123456789"



gemini-list-image-sessions


List all active editing sessions.

gemini-generate-video


Generate videos using Veo:


prompt: "a cat playing piano"
aspectRatio: "16:9" (optional)
negativePrompt: "blurry, text" (optional)



Video generation is async (takes 1-5 minutes). Use

gemini-check-video

 to poll.

gemini-check-video


Check video generation status and download when complete:


operationId: "operations/xxx-xxx-xxx"



gemini-analyze-code


Analyze code for issues:


code: "function foo() { ... }"
language: "typescript" (optional)
focus: "quality" | "security" | "performance" | "bugs" | "general"



gemini-analyze-text


Analyze text content:


text: "Your text here..."
type: "sentiment" | "summary" | "entities" | "key-points" | "general"



gemini-brainstorm


Collaborative brainstorming:


prompt: "How could we implement real-time collaboration?"
claudeThoughts: "I think we should use WebSockets..."
maxRounds: 3 (optional)



gemini-summarize


Summarize content:


content: "Long text to summarize..."
length: "brief" | "moderate" | "detailed"
format: "paragraph" | "bullet-points" | "outline"



gemini-run-code


Let Gemini write and execute Python code:


prompt: "Calculate the first 50 prime numbers and plot them"
data: "optional CSV data to analyze" (optional)



Supports libraries: numpy, pandas, matplotlib, scipy, scikit-learn, tensorflow, and more.
Generated charts are saved to the output directory and returned as images.

gemini-search


Real-time web search with citations:


query: "What happened in tech news this week?"
returnCitations: true (default)



Returns grounded responses with inline citations and source URLs.

gemini-structured


Get JSON responses matching a schema:


prompt: "Extract the meeting details from this email..."
schema: '{"type":"object","properties":{"date":{"type":"string"},"attendees":{"type":"array"}}}'
useGoogleSearch: false (optional)



gemini-extract


Convenience tool for common extraction patterns:


text: "Your text to analyze..."
extractType: "entities" | "facts" | "summary" | "keywords" | "sentiment" | "custom"
customFields: "name, date, amount" (for custom extraction)



gemini-youtube


Analyze YouTube videos directly:


url: "https://www.youtube.com/watch?v=..."
question: "What happens at 2:30?"
startTime: "1m30s" (optional, for clipping)
endTime: "5m00s" (optional, for clipping)



gemini-youtube-summary


Quick video summarization:


url: "https://www.youtube.com/watch?v=..."
style: "brief" | "detailed" | "bullet-points" | "chapters"



gemini-analyze-document


Analyze PDFs and documents:


filePath: "/path/to/document.pdf"
question: "Summarize the key findings"
mediaResolution: "low" | "medium" | "high"



gemini-summarize-pdf


Quick PDF summarization:

`` filePath: "/path/to/document.pdf" style: "brief" | "de

…

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

MCP Server Gemini

Features

Quick Installation

MCP Server for Claude Code

Using npm (Recommended)

Using bun

CLI (Global Install)

Install globally

Set your API key once (stored securely)

Now use any command!

Installation Options

With verbose logging

With custom output directory for generated images/videos

Available Tools

gemini-query

gemini-generate-image

gemini-start-image-edit

gemini-continue-image-edit

gemini-end-image-edit

gemini-list-image-sessions

gemini-generate-video

gemini-check-video

gemini-analyze-code

gemini-analyze-text

gemini-brainstorm

gemini-summarize

gemini-run-code

gemini-search

gemini-structured

gemini-extract

gemini-youtube

gemini-youtube-summary

gemini-analyze-document

gemini-summarize-pdf

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive