houtini-ai avatar

Gemini

houtini-ai/gemini-mcp

Wraps Google's Gemini models as MCP tools inside Claude Desktop. The real utility isn't just chat, it's the stuff Gemini does natively: grounded search that pulls live Google results before answering, Imagen for image generation with current data lookup, Veo for video synthesis, and SVG diagram rendering that outputs clean vector code you can commit straight to a repo. Deep research runs multi-iteration searches then synthesizes a full report. Image editing maintains conversational context across turns via thought signatures. Thirteen tools total, all stdio transport. Works via npx with just an API key from Google AI Studio. Free tier covers most development use.

GitHub stars
34
tools
8
auth
Secret needed
transport
STDIO
env var
1
last updated
Oct 24, 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

Configuration

GEMINI_API_KEY*secret

Google AI Studio API key (get from https://aistudio.google.com/apikey)

Readme

Gemini MCP

Gemini MCP - Google Gemini image generation, video and search grounding inside Claude

npm version MCP Registry Known Vulnerabilities Socket Badge License: Apache 2.0


View the full README on GitHub

Details

Repository
github.com/houtini-ai/gemini-mcp
Website
houtini.com/gemini-mcp
Categories
AI & LLM Tools, Communication & Messaging
Package
@houtini/gemini-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from houtini-ai

Related AI & LLM Tools MCP servers

View all
1neverinfamous avatarNeverinfamous Memory Journal Mcpneverinfamous/memory-journal-mcpA MCP server built for developers enabling Git based project management with project and personal…17stars
2drqedwards avatarPmll Memory Mcpdrqedwards/ppmPMLL Memory MCP — persistent KV context memory and Q-promise deduplication.14stars
3chenxiaofie avatarMemory Mcpchenxiaofie/memory-mcp情景+实体记忆 MCP 服务,为 Claude Code 提供持久化记忆能力11stars
4usejunior avatarAgent Emailusejunior/email-agent-mcpLocal email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP7stars
5agentic-eng avatarA2dbagentic-eng/a2dbSafe, read-only database access for AI agents. 5 databases, batch queries, SQLGlot.2stars
6elfsight avatarElfsight AI Chatbotelfsight/ai-chatbot-mcpRead conversations, leads, knowledge base and analytics of your Elfsight AI Chatbot widgets.2stars