MCP Gemini

Name: MCP Gemini
Author: crunchtools

by crunchtoolsversion 0.3.0i★ 0iRuns on your computer

Registry nameio.github.crunchtools/gemini

How to install

What it does

MCP server for Google Gemini AI - text, image, video, research, and more

Connects Runs on your computer
Account or key No key needed
Category Design, images & audio

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

ClaudeWeb · app · phoneChatGPTWebClaude CodeTerminalCursorCode editorVS CodeCode editorOtherOther apps

Pick your app and the steps appear below.

Works with Claude, with some setup first

Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Done

Paste these settings and save the file

{
  "mcpServers": {
    "gemini": {
      "command": "uvx",
      "args": [
        "mcp-gemini-crunchtools"
      ]
    }
  }
}

Done

Quit Claude and open it again
Done
Try it
Use MCP Gemini and tell me what you can do for me, then show me one thing
✓ If Claude says it is using MCP Gemini or shows a MCP Gemini tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect MCP Gemini yet

MCP Gemini runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect MCP Gemini

Steps for Claude →Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Steps for Claude Code →Install Python (uv) on your computer first (one time)
Steps for Cursor →Install Python (uv) on your computer first (one time)
Steps for VS Code →Install Python (uv) on your computer first (one time)

B · Others in Design, images & audio that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Pascal 3D Editor✓ ChatGPT
Semiotic✓ ChatGPT
TypeUI✓ ChatGPT

Works with Claude Code, with some setup first

Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Done

Paste this command and press Enter

claude mcp add --scope user gemini -- uvx mcp-gemini-crunchtools

Done

Type /mcp in Claude Code
You should see MCP Gemini listed as connected
Done
Try it
Use MCP Gemini and tell me what you can do for me, then show me one thing
✓ If Claude Code says it is using MCP Gemini or shows a MCP Gemini tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor, with some setup first

Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Click this button to open Cursor
Open in Cursor
Cursor asks you to confirm; click Install
Done
Open the AI chat in Cursor in Agent mode
Done
Try it
Use MCP Gemini and tell me what you can do for me, then show me one thing
✓ If Cursor says it is using MCP Gemini or shows a MCP Gemini tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code, with some setup first

Install Python (uv) on your computer first (one time)

Install Python (uv)
One time only; it works for every server that needs Python (uv)
Open the Python (uv) download page ↗
Done
Click this button to open VS Code
Open in VS Code
VS Code asks you to confirm; click Install
Done
Open the AI chat in VS Code in Agent mode
Done
Try it
Use MCP Gemini and tell me what you can do for me, then show me one thing
✓ If VS Code says it is using MCP Gemini or shows a MCP Gemini tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use MCP Gemini💬 Discussion →

For developers: Terminal commands and JSON settings

Installed on your computer

Claude Code

claude mcp add --scope user gemini -- uvx mcp-gemini-crunchtools

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gemini": {
      "command": "uvx",
      "args": [
        "mcp-gemini-crunchtools"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "gemini": {
      "command": "uvx",
      "args": [
        "mcp-gemini-crunchtools"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "gemini": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-gemini-crunchtools"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

GitHub stars i: 0
Downloads per weeki: 2,247/wk
Licence i: AGPL-3.0
Connection: Runs on your computer
Transport: stdio
Latest versioni: 0.3.0
Categoryi: Design, images & audio
Published to registryi: Mar 2, 2026
Code last changedi: Nov 12, 2026
Maker: crunchtools
Packages: pypi: mcp-gemini-crunchtools
Repo: crunchtools/mcp-gemini
Registry status: Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 13, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account crunchtools, which owns the repo
✓ Pass
Still maintained
Code last changed yesterday
✓ Pass
Has a licence
Uses AGPL-3.0
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

User reviews

No reviews yet

Compared with others in Design, images & audioi

More stars than 0% of the other 2980 servers in this category
Published to the registry more recently than 2% of the other 2980 servers in this category
Basic checks equal to or better than 100% of the other 2980 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is MCP Gemini safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (0.3.0) reached the registry 9 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Figma Context MCP, AutoClip, Next AI Draw.io

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Figma Context MCP

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

by GLipsWidely used↓ 152.1K/wk★ 16.2KUpdated 5 months ago

Runs on your computer

Install

AutoClip

Clip long videos into short clips with covers and captions. Local CLI and MCP.

by zhouxiaokaWidely used↓ 205/wk★ 10.4KUpdated 16 days ago

Runs on your computer

Install

Next AI Draw.io

draw.io diagrams your AI agent draws on a live browser canvas that you can also edit by hand

by DayuanJiangWidely used↓ 21.7K/wk★ 36.9K Stars for the whole repoUpdated 6 days ago

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

Component	Name
GitHub repo	crunchtools/mcp-gemini
Container	`quay.io/crunchtools/mcp-gemini`
Python package (PyPI)	`mcp-gemini-crunchtools`
CLI command	`mcp-gemini-crunchtools`
Module import	`mcp_gemini_crunchtools`

Why Hummingbird?

The container image is built on the Hummingbird Python base image from Project Hummingbird, which provides:

Minimal CVE exposure - Hummingbird images are built with a minimal package set, dramatically reducing the attack surface compared to general-purpose images
Regular updates - Security patches are applied promptly, keeping CVE counts low
Optimized for Python - Pre-configured Python environment with uv package manager for fast, reproducible builds
Production-ready - Designed for production workloads with proper signal handling and non-root user defaults

This means your MCP server runs in a hardened environment with fewer vulnerabilities than typical Python container images.

Features

Query Tools (5 tools)

gemini_query - Query Gemini with optional Google Search grounding
gemini_brainstorm - Generate creative ideas on a topic
gemini_analyze_code - Analyze code for security, performance, bugs
gemini_analyze_text - Analyze text for sentiment, tone, content
gemini_summarize - Summarize content in various formats

Image Generation (4 tools)

gemini_generate_image - Generate images from text prompts (native Gemini)
gemini_generate_image_with_input - Edit/modify existing images
gemini_image_prompt - Craft effective image generation prompts
gemini_imagen_generate - Generate images using Google Imagen 4 models

Image Editing (4 tools)

gemini_start_image_edit - Start a multi-turn image editing session
gemini_continue_image_edit - Continue editing in an active session
gemini_end_image_edit - End an image editing session
gemini_list_image_sessions - List all active editing sessions

Image Analysis (1 tool)

gemini_analyze_image - Analyze and describe local image files

Search Tools (1 tool)

gemini_search - Web search using Gemini with Google Search grounding

Document Tools (3 tools)

gemini_analyze_document - Analyze PDFs, DOCX, TXT, etc.
gemini_summarize_pdf - Summarize PDF documents
gemini_extract_tables - Extract tables from documents

URL Tools (3 tools)

gemini_analyze_url - Analyze one or more URLs
gemini_compare_urls - Compare two URLs
gemini_extract_from_url - Extract specific data from a URL

Video Tools (2 tools)

gemini_generate_video - Generate videos using Veo
gemini_check_video - Check video generation status

YouTube Tools (2 tools)

gemini_youtube - Analyze YouTube videos
gemini_youtube_summary - Summarize YouTube videos

Voice Tools (3 tools)

gemini_speak - Convert text to speech
gemini_dialogue - Generate multi-voice dialogue audio
gemini_list_voices - List available voices

Research Tools (3 tools)

gemini_deep_research - Perform multi-step web research
gemini_check_research - Check research operation status
gemini_research_followup - Ask follow-up questions

Cache Tools (4 tools)

gemini_create_cache - Create content cache for repeated queries
gemini_query_cache - Query cached content
gemini_list_caches - List all active caches
gemini_delete_cache - Delete a cache

Structured Output Tools (2 tools)

gemini_structured - Get structured JSON output
gemini_extract - Extract structured data from text

Token Tools (1 tool)

gemini_count_tokens - Count tokens in content

Code Execution Tools (1 tool)

gemini_run_code - Execute Python code via Gemini

Total: 39 tools

Installation

With uvx (Recommended)

uvx mcp-gemini-crunchtools

With pip

pip install mcp-gemini-crunchtools

With Container

# Create a shared output directory (required before first run)

mkdir -p ~/.local/share/mcp-uploads-downloads

podman run -v ~/.local/share/mcp-uploads-downloads:/output:z \ -e GEMINI_API_KEY=your_key \ -e GEMINI_OUTPUT_DIR=/output \ quay.io/crunchtools/mcp-gemini

SELinux note: Use :z (lowercase, shared) instead of :Z (uppercase, private).

MCP servers run as long-lived stdio processes. With :Z, files copied into the

directory after container start won't have the container's private MCS label and

will be invisible inside the container. The :z flag sets a shared

container_file_t context that all containers and the host can read/write.

Tip: Use the same shared directory (~/.local/share/mcp-uploads-downloads/)

across multiple MCP container servers (e.g., mcp-gemini and mcp-wordpress) so

generated images are immediately available for WordPress upload without copying.

Configuration

Creating a Google Gemini API Key

Navigate to Google AI Studio

Go to https://aistudio.google.com/apikey
Sign in with your Google account

Create API Key

Click "Get API key" or "Create API key"
Select a Google Cloud project or create a new one
Click "Create API key in new project" (or select existing project)

Copy Your API Key

IMPORTANT: Copy the API key immediately - store it securely!
The key starts with AI... (e.g., AIzaSy...)

Add to Claude Code

claude mcp add mcp-gemini-crunchtools \

--env GEMINI_API_KEY=your_api_key_here \ -- uvx mcp-gemini-crunchtools

Or for the container version:

# Create a shared output directory (required before first run)

mkdir -p ~/.local/share/mcp-uploads-downloads

claude mcp add mcp-gemini-crunchtools \ --env GEMINI_API_KEY=your_api_key_here \ --env GEMINI_OUTPUT_DIR=/output \ -- podman run -i --rm \ -v ~/.local/share/mcp-uploads-downloads:/output:z \ -e GEMINI_API_KEY \ -e GEMINI_OUTPUT_DIR=/output \ quay.io/crunchtools/mcp-gemini

Optional: Set Output Directory (non-container)

For generated images, audio, and videos when running without a container:

claude mcp add mcp-gemini-crunchtools \

--env GEMINI_API_KEY=your_api_key_here \ --env GEMINI_OUTPUT_DIR=$HOME/.local/share/mcp-uploads-downloads \ -- uvx mcp-gemini-crunchtools

Usage Examples

Query with Google Search

User: What are the latest developments in quantum computing?

Assistant: [calls gemini_query with use_google_search=true]

Generate an Image

User: Generate a photorealistic image of a sunset over mountains

Assistant: [calls gemini_generate_image with prompt and style]

Analyze a PDF Document

User: Analyze this research paper at /path/to/paper.pdf

Assistant: [calls gemini_analyze_document with file_path]

Summarize a YouTube Video

User: Summarize this YouTube video: https://youtube.com/watch?v=...

Assistant: [calls gemini_youtube_summary with url]

Deep Research

User: Research the environmental impact of electric vehicles

Assistant: [calls gemini_deep_research then gemini_check_research]

Code Analysis

User: Analyze this Python code for security issues

Assistant: [calls gemini_analyze_code with focus="security"]

Security

This server was designed with security as a primary concern. See SECURITY.md for:

Threat model and attack vectors
Defense in depth architecture
API key handling best practices
Input validation rules
Audit logging

Key Security Features

API Key Protection

Stored as SecretStr (never accidentally logged)
Environment variable only (never in files or args)
Sanitized from all error messages

Input Validation

Pydantic models for all inputs
File path validation
URL validation
Strict format validation

API Hardening

Hardcoded API base URL (prevents SSRF)
TLS certificate validation
Request timeouts
Response size limits

Automated CVE Scanning

GitHub Actions scan dependencies weekly
Automatic PRs for security updates
Dependabot alerts enabled

Development

Setup

git clone https://github.com/crunchtools/mcp-gemini.git

cd mcp-gemini uv sync

Run Tests

uv run pytest

Lint and Type Check

uv run ruff check src tests

uv run mypy src

Build Container

podman build -t mcp-gemini .

License

AGPL-3.0-or-later

Contributing

Contributions welcome! Please read SECURITY.md before submitting security-related changes.

MCP Gemini

What it does

Install

Install Python (uv)

Open the Claude desktop app’s settings file

Paste these settings and save the file

Quit Claude and open it again

Try it

What you can do instead

Install Python (uv)

Open Terminal

Paste this command and press Enter

Type /mcp in Claude Code

Try it

Install Python (uv)

Click this button to open Cursor

Open the AI chat in Cursor in Agent mode

Try it

Install Python (uv)

Click this button to open VS Code

Open the AI chat in VS Code in Agent mode

Try it

Installed on your computer

At a glance

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Discussion

User reviews

Compared with others in Design, images & audioi

Common questions

Others in the same category

Figma Context MCP

AutoClip

Next AI Draw.io

README from the maker

MCP Gemini CrunchTools

Overview

Naming Convention

Why Hummingbird?

Features

Query Tools (5 tools)

Image Generation (4 tools)

Image Editing (4 tools)

Image Analysis (1 tool)

Search Tools (1 tool)

Document Tools (3 tools)

URL Tools (3 tools)

Video Tools (2 tools)

YouTube Tools (2 tools)

Voice Tools (3 tools)

Research Tools (3 tools)

Cache Tools (4 tools)

Structured Output Tools (2 tools)

Token Tools (1 tool)

Code Execution Tools (1 tool)

Installation

With uvx (Recommended)

With pip

With Container

Configuration

Creating a Google Gemini API Key

Add to Claude Code

Optional: Set Output Directory (non-container)

Usage Examples

Query with Google Search

Generate an Image

Analyze a PDF Document

Summarize a YouTube Video

Deep Research

Code Analysis

Security

Key Security Features