crunchtools avatar

MCP Gemini

crunchtools/mcp-gemini

Connects Claude to Google's Gemini AI with 39 tools spanning text generation, image creation via Imagen 4, video generation with Veo, document analysis, YouTube summarization, text-to-speech, and multi-step web research. You get structured output extraction, content caching for repeated queries, code execution, and Google Search grounding for queries. Notable for image editing sessions where you can iteratively refine generated images across multiple turns. Runs locally via stdio so your API key stays on your machine. Reach for this when you want Claude to tap Gemini's multimodal capabilities, especially for tasks like analyzing PDFs, generating videos, or running deep research operations that span multiple web sources.

tools
8
transport
STDIO
last updated
Mar 2, 2026

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/...')

Sponsors

Readme

MCP Gemini CrunchTools

A secure MCP (Model Context Protocol) server for Google Gemini AI - text, image, video, research, and more.

Overview

This MCP server is designed to be:

  • Secure by default - STRIDE threat model (see SECURITY.md), Pydantic input validation, and the API key held as a SecretStr to prevent accidental logging
  • No third-party services - Runs locally via stdio, your API key never leaves your machine
  • Cross-platform - Works on Linux, macOS, and Windows
  • Automatically updated - GitHub Actions monitor for CVEs and update dependencies
  • Containerized - Available at quay.io/crunchtools/mcp-gemini built on Hummingbird Python base image

Naming Convention

ComponentName
GitHub repocrunchtools/mcp-gemini
Containerquay.io/crunchtools/mcp-gemini
Python package (PyPI)mcp-gemini-crunchtools
CLI commandmcp-gemini-crunchtools
Module importmcp_gemini_crunchtools

Why Hummingbird?


View the full README on GitHub

Details

Repository
github.com/crunchtools/mcp-gemini
Categories
AI & LLM Tools, Media & Entertainment
Package
mcp-gemini-crunchtools
Transport
STDIO
Registry
MCP registry, active

More from crunchtools

Related AI & LLM Tools MCP servers

View all
1digbyo avatarColour Memorydigbyo/colour-memory-apiColour meaning, history and evidence for AI: 45,000+ source-graded colour records and 91 tools.0stars
2hatgit avatarForex-GPT MCP Serverio.github.hatgit/forex-gpt-mcpAI-powered forex and crypto trading analysis with real-time data across 127+ instruments.0stars
3jacobsd32-cpu avatarDjd Agent Scorejacobsd32-cpu/djd-agent-score-mcpReputation scoring for AI agent wallets on Base. Trust scores, fraud checks, x402.0stars
4lazymac2x avatarAgent Loop Detectorlazymac2x/agent-loop-detector-apiCloudflare Workers MCP server: agent-loop-detector0stars
5lazymac2x avatarAgent Trace Auditorlazymac2x/agent-trace-auditor-apiCloudflare Workers MCP server: agent-trace-auditor0stars
6lazymac2x avatarAgent Workflow Enginelazymac2x/agent-workflow-engine-apiCloudflare Workers MCP server: agent-workflow-engine0stars