Gemini Mcp

rlabs-inc/gemini-mcp

Connects Claude to Google's Gemini 3 models through MCP, giving you access to Gemini's text generation, image creation with Nano Banana Pro, video generation via Veo 2.0, and code execution capabilities. You can run collaborative brainstorming sessions between Claude and Gemini, analyze YouTube videos and documents, perform real-time web searches with citations, and execute Python code with data visualization. The server handles multi-turn image editing sessions and supports structured JSON output with schema validation. Reach for this when you need Gemini's specific strengths like video generation or want to combine both AI systems for complex research and analysis tasks.

GitHub stars: 203
tools: 8
auth: Secret needed
transport: STDIO
env vars: 2
last updated: Jan 5, 2026

View on GitHub

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

GEMINI_COUNT_TOKENSCounts the number of tokens in text using Gemini tokenization. Useful for estimating costs, checking input limits, and optimizing prompts before making API calls.2 params

Counts the number of tokens in text using Gemini tokenization. Useful for estimating costs, checking input limits, and optimizing prompts before making API calls.

Parameters* required

modelstring

Model to use for token counting. Examples: 'gemini-1.5-flash', 'gemini-1.5-pro'default: gemini-1.5-flash

textstring

Text to count tokens for

GEMINI_EMBED_CONTENTGenerates text embeddings using Gemini embedding models. Converts text into numerical vectors for semantic search, similarity comparison, clustering, and classification tasks.4 params

Generates text embeddings using Gemini embedding models. Converts text into numerical vectors for semantic search, similarity comparison, clustering, and classification tasks.

Parameters* required

modelstring

Embedding model to use. Examples: 'text-embedding-004', 'embedding-001'default: text-embedding-004

task_typestring

Task type: 'RETRIEVAL_QUERY', 'RETRIEVAL_DOCUMENT', 'SEMANTIC_SIMILARITY', 'CLASSIFICATION', 'CLUSTERING'

textstring

Text to generate embeddings for

titlestring

Optional title for the content (for document embeddings)

GEMINI_GENERATE_CONTENTGenerates text content from prompts using Gemini models. Supports various models like Gemini Flash and Pro with configurable temperature, token limits, and safety settings for diverse text generation tasks.9 params

Generates text content from prompts using Gemini models. Supports various models like Gemini Flash and Pro with configurable temperature, token limits, and safety settings for diverse text generation tasks.

Parameters* required

max_output_tokensinteger

Maximum number of tokens to generate

modelstring

Model to use. Examples: 'gemini-1.5-flash', 'gemini-1.5-pro', 'gemini-2.0-flash-exp'default: gemini-1.5-flash

promptstring

Text prompt for content generation

safety_settingsarray

Safety filter settings

stop_sequencesarray

Sequences where generation should stop

system_instructionstring

System instruction to guide the model's behavior

temperaturenumber

Controls randomness (0.0 to 2.0)

top_kinteger

Top-k sampling parameter

top_pnumber

Nucleus sampling parameter (0.0 to 1.0)

GEMINI_GENERATE_IMAGEGenerates images from text prompts using Gemini 2.5 Flash Image Preview model (Nano Banana). Supports creative image generation with customizable parameters like aspect ratio, safety settings, and optional local file saving. Generated images are automatically uploaded to S3 an...9 params

Generates images from text prompts using Gemini 2.5 Flash Image Preview model (Nano Banana). Supports creative image generation with customizable parameters like aspect ratio, safety settings, and optional local file saving. Generated images are automatically uploaded to S3 an...

Parameters* required

max_output_tokensinteger

Maximum number of tokens to generate (max 32,768)

modelstring

Model to use. Use 'gemini-2.5-flash-image-preview' for image generationdefault: gemini-2.5-flash-image-preview

promptstring

Text prompt for image generation

safety_settingsarray

Safety filter settings

save_pathstring

Optional local path to save the generated image

system_instructionstring

System instruction to guide image generation behavior

temperaturenumber

Controls randomness (0.0 to 2.0)

top_kinteger

Top-k sampling parameter

top_pnumber

Nucleus sampling parameter (0.0 to 1.0)

GEMINI_GENERATE_VIDEOSGenerates videos from text prompts using Google's Veo models. Creates high-quality video content. Returns operation ID for tracking progress. After this, call GEMINI_WAIT_FOR_VIDEO to download the video using the operation ID.4 params

Generates videos from text prompts using Google's Veo models. Creates high-quality video content. Returns operation ID for tracking progress. After this, call GEMINI_WAIT_FOR_VIDEO to download the video using the operation ID.

Parameters* required

extrasobject

Additional parameters passed through to API

modelstring

Model to use. Examples: 'veo-3.0-generate-preview', 'veo-3.0-fast-generate-preview', 'veo-2.0-generate-001'default: veo-3.0-generate-preview

person_generationstring

Controls person generation in videos. Values: 'allow_adult' or 'dont_allow'. IMPORTANT: Veo 3 models in EU/UK/CH/MENA regions ONLY support 'allow_adult'. Veo 2 models support both values in all reg...

promptstring

Text prompt for Veo video generation

GEMINI_GET_VIDEOS_OPERATIONChecks the status of a Veo video generation operation. Use the operation name from GenerateVideos to track progress and get the download URL when complete.1 params

Checks the status of a Veo video generation operation. Use the operation name from GenerateVideos to track progress and get the download URL when complete.

Parameters* required

operation_namestring

Operation resource name returned by predictLongRunning

GEMINI_LIST_MODELSLists available Gemini and Veo models with their capabilities and limits. Useful for discovering supported models and their features before making generation requests.1 params

Lists available Gemini and Veo models with their capabilities and limits. Useful for discovering supported models and their features before making generation requests.

Parameters* required

filter_prefixstring

Filter models by name prefix (client-side). Leave empty to get all models.default:

GEMINI_WAIT_FOR_VIDEOPolls a Veo video generation operation until completion, then downloads and returns the video as a FileDownloadable with public URL.1 params

Polls a Veo video generation operation until completion, then downloads and returns the video as a FileDownloadable with public URL.

Parameters* required

operation_namestring

The operation name from video generation (e.g., 'models/...')

Configuration

GEMINI_API_KEY*secret

Your Google Gemini API key (get one at https://aistudio.google.com/apikey)

GEMINI_OUTPUT_DIR

Directory for generated files (images, videos, audio)

Readme

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

View the full README on GitHub

Details

Repository: github.com/rlabs-inc/gemini-mcp
Categories: AI & LLM Tools, Media & Entertainment
Package: @rlabs-inc/gemini-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related AI & LLM Tools MCP servers

View all

Yolfi Payments MCPyolfinance/yolfi-agentLet AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks.176stars

Svelte Llm Mcpkhromov/svelte-llm-mcpAn MCP server that provides access to Svelte 5 and SvelteKit documentation161stars

Mcp Serverbingowon/apple-rag-mcpApple developer docs and WWDC transcripts with RAG retrieval and Jev relevance ranking.119stars

agent-stracesiddhant-k-code/agent-traceQuery recorded AI agent sessions: events, summaries, diffs, health, skills, PR reviewability.104stars

Memory Mcpyuvalsuede/memory-mcpPersistent memory + git snapshots for Claude Code. Never lose context or code.97stars

Agentic Mermaidadewale/agentic-mermaidRender, verify, describe, and safely edit Mermaid diagrams through MCP.69stars