MCP Gemini CrunchTools
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GEMINI_API_KEY | Yes | Your Google Gemini API key. Required to authenticate with the Gemini API. | |
| GEMINI_OUTPUT_DIR | No | Directory where generated images, audio, and videos are saved. Optional for non‑container usage; defaults to a system-dependent location if not set. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Secure MCP server for Google Gemini AI - text, image, video, research, and more. Generated files (images, audio, video) are saved to the output directory. When running natively (uvx/uv), the default output directory is ~/.config/mcp-gemini-crunchtools/output (override with GEMINI_OUTPUT_DIR). When running as a container, files must be placed in ~/.local/share/mcp-uploads-downloads/ on the host (mounted to /output inside the container). Use absolute paths like /output/image.png for file_path parameters. Input files for analysis (images, documents, PDFs) must also be accessible at this same mount path when running as a container.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gemini_query_toolC | Query Gemini with a prompt. Supports Google Search grounding. |
| gemini_brainstorm_toolC | Brainstorm ideas on a topic using Gemini. |
| gemini_analyze_code_toolC | Analyze code with Gemini. |
| gemini_analyze_text_toolC | Analyze text with Gemini. |
| gemini_summarize_toolC | Summarize content with Gemini. |
| gemini_generate_image_toolB | Generate an image from a text prompt using Gemini's native image model. |
| gemini_generate_image_with_input_toolA | Generate/edit an image using a local image file as input. Upload a local image and give Gemini instructions for how to modify it. Use cases: add watermarks, change styles, composite images, etc. |
| gemini_image_prompt_toolC | Help craft an effective image generation prompt. |
| gemini_imagen_generate_toolA | Generate images using Google Imagen 4 models. Models (sorted by price):
|
| gemini_start_image_edit_toolA | Start a multi-turn image editing session. Optionally provide an existing image file as the starting point. Without file_path, Gemini generates a new image from the prompt. Use gemini_continue_image_edit_tool to make further edits. |
| gemini_continue_image_edit_toolC | Continue editing in an active image session. |
| gemini_end_image_edit_toolB | End an image editing session and free resources. |
| gemini_list_image_sessions_toolB | List all active image editing sessions. |
| gemini_analyze_image_toolC | Analyze and describe a local image file. |
| gemini_search_toolB | Search the web using Gemini with Google Search grounding. |
| gemini_analyze_document_toolC | Analyze a document (PDF, DOCX, TXT, etc.). |
| gemini_summarize_pdf_toolC | Summarize a PDF document. |
| gemini_extract_tables_toolC | Extract tables from a document. |
| gemini_analyze_url_toolC | Analyze one or more URLs. |
| gemini_compare_urls_toolC | Compare two URLs. |
| gemini_extract_from_url_toolC | Extract specific data from a URL. |
| gemini_generate_video_toolB | Generate a video using Veo. Returns an operation ID to poll. |
| gemini_check_video_toolB | Check the status of a video generation operation. |
| gemini_youtube_toolC | Analyze a YouTube video. |
| gemini_youtube_summary_toolC | Summarize a YouTube video. |
| gemini_speak_toolC | Convert text to speech. |
| gemini_dialogue_toolC | Generate multi-voice dialogue audio. |
| gemini_list_voices_toolA | List available voices for text-to-speech. |
| gemini_deep_research_toolB | Start a deep research task using a specialized Gemini model. Performs multi-step web research to answer complex questions. Completes in a single call; the result is returned immediately. |
| gemini_check_research_toolC | Check the status of a deep research operation. |
| gemini_research_followup_toolB | Ask a follow-up question about completed research. |
| gemini_create_cache_toolB | Create a content cache for repeated queries. Upload content once and query it multiple times without re-sending. |
| gemini_query_cache_toolC | Query content in a cache. |
| gemini_list_caches_toolB | List all active content caches. |
| gemini_delete_cache_toolC | Delete a content cache. |
| gemini_structured_toolC | Get structured JSON output from Gemini. |
| gemini_extract_toolC | Extract structured data from text. |
| gemini_count_tokens_toolB | Count the number of tokens in content. |
| gemini_run_code_toolB | Execute code using Gemini's built-in code execution. Gemini writes and runs Python code to answer questions, perform calculations, or process data. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 39 tools
Many tools overlap: multiple image generation/editing tools (gemini_generate_image_tool, gemini_imagen_generate_tool, gemini_generate_image_with_input_tool, gemini_start_image_edit_tool), multiple document analysis tools (analyze_document, summarize_pdf, extract_tables), multiple URL tools (analyze_url, compare_urls, extract_from_url), and general query/analyze/summarize/brainstorm tools. Descriptions help but boundaries are fuzzy, risking misselection.
All tools use snake_case with a consistent 'gemini_' prefix and '_tool' suffix. However, some names lack an action verb (gemini_youtube_tool, gemini_dialogue_tool, gemini_structured_tool) and word order varies (gemini_imagen_generate_tool vs gemini_generate_image_tool), preventing a perfect score.
39 tools is well above the recommended 3-15 range and exceeds the 25-tool threshold for 'too many.' While the server covers many modalities, the count suggests redundant or overly granular tooling that could be consolidated.
The toolset covers a wide range of Gemini capabilities: image/video/audio generation, document/URL/YouTube analysis, research, caching, structured output, token counting, and code execution. Minor gaps exist (e.g., no speech-to-text, no model listing, no embedding generation), but core workflows are well supported.