Gemini MCP
Generate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models.
Connector by chrischall · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/chrischall-gemini-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 8 read · 1 write · 12 delete · 1 not yet classified
- Secrets
- 1 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 22
Read from the source code; the running server may list different tools.
Read 8 · Look things up without changing anything.
gemini_get_upload_urlgemini_list_charactersgemini_list_filesgemini_list_modelsgemini_list_recent_mediagemini_list_stylesgemini_sign_mediagemini_view_media
Write 1 · Create, change, send or run things.
gemini_upload_file
Delete 12 · Delete, drop, revoke or wipe things.
gemini_delete_charactergemini_delete_filegemini_delete_stylegemini_get_resultgemini_image_editgemini_image_generategemini_image_setgemini_interactgemini_music_generategemini_save_charactergemini_save_stylegemini_video_generate
Not yet classified 1 · We could not tell from the name and description.
gemini_token_usage
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
GEMINI_API_KEY
Other settings (environment variables or headers).
GEMINI_CHAIN_RETRY_MSGEMINI_DEBUGGEMINI_HEARTBEAT_MSGEMINI_IMAGE_MODELGEMINI_INPUT_DIRGEMINI_OUTPUT_DIRGEMINI_RATE_CARDGEMINI_REFERENCE_DIRGEMINI_TIMEOUT_MSGEMINI_UPLOAD_DIR
Files it touches
- Any path the agent passes to its tools
Tools (22)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
gemini_delete_charactercan change or delete dataDescription is built at runtime.
gemini_delete_filecan change or delete dataDescription is built at runtime.
gemini_delete_stylecan change or delete dataDescription is built at runtime.
gemini_get_resultcan change or delete dataRetrieve a generation started with `async: true` or handed off by `max_wait_ms`. Pass the returned `job_id`: while running it reports status "running"; on completion it returns the normal result (image URLs/paths + meta); on failure it raises the recorded error, including the case where the generation was killed before it finished. On the hosted connector job records are stored durably and survive a restart; on a local stdio server they live with the process and expire ~10 min after completion, where the output dir / <image>.json sidecar is the fallback. A killed video/music job started with `…
gemini_get_upload_urlread-onlyDescription is built at runtime.
gemini_image_editcan change or delete dataDescription is built at runtime.
gemini_image_generatecan change or delete dataDescription is built at runtime.
gemini_image_setcan change or delete dataDescription is built at runtime.
gemini_interactcan change or delete dataDescription is built at runtime.
gemini_list_charactersread-onlyList this account's saved characters (persistent reference library): names, descriptions and timestamps. Pass characters: ["<name>", …] on gemini_image_generate / gemini_image_edit / gemini_image_set and the saved reference image + description are attached to the request automatically — nothing to re-upload and no bytes in the conversation.
gemini_list_filesread-onlyList files, images and photos currently uploaded to the Gemini Files API under this API key, with their reusable `file_uri` (`files/<id>`) references, MIME types and expiry times. Retention is ~48h, so an entry that has vanished has expired rather than failed.
gemini_list_modelsList the Gemini image-generation models available to your API key (Nano Banana / Nano Banana Pro family), and the current default model.
gemini_list_recent_mediaread-onlyList images/video/audio this connector recently generated for your account, newest first, with fresh openable URLs. Use it when a result was lost — a generation whose response never arrived, or an async job whose id came back unknown — to find what already exists BEFORE re-running (and re-paying for) it. Keywords: lost result, orphaned job, missing image, what did I generate, recover, recent media.
gemini_list_stylesread-onlyList this account's saved style presets (persistent reference library). Pass style: "<name>" on gemini_image_generate / gemini_image_edit / gemini_image_set and the saved prompt fragment (and reference image, if any) are applied automatically.
gemini_music_generatecan change or delete dataDescription is built at runtime.
Show 7 more tools
gemini_save_charactercan change or delete dataSave a named character to this account's persistent reference library: one reference image plus a short description. Saved characters have NO expiry — unlike uploads (~retention window) and Files API references (~48h) — so a name saved once keeps working in every later session. Re-saving a name replaces it. Pass characters: ["<name>", …] on gemini_image_generate / gemini_image_edit / gemini_image_set and the saved reference image + description are attached to the request automatically — nothing to re-upload and no bytes in the conversation.
gemini_save_stylecan change or delete dataSave a named style preset to this account's persistent reference library: a reusable prompt fragment (and optionally a reference image) that a single word then applies to any generation. No expiry; re-saving a name replaces it. Pass style: "<name>" on gemini_image_generate / gemini_image_edit / gemini_image_set and the saved prompt fragment (and reference image, if any) are applied automatically.
gemini_sign_mediaread-onlyMint a FRESH signed URL for media this connector generated, from its `r2_key`. Signed media links expire well before the object behind them is cleaned up, so an expired link is not a dead end — re-sign it instead of re-generating (and re-paying for) the image. Keywords: expired link, refresh url, re-sign, media url, download again.
gemini_token_usageToken usage for this session so far — what every generation has cost in tokens, added up. Call it before and after a workflow and subtract to get that workflow's cost; call it after a single generation for that call's. Reports tokens AND an estimated USD cost, priced per call against each call's own model and stamped with the date its rates were read (override with GEMINI_RATE_CARD). Note there is no account-balance endpoint to query — Google Cloud is post-paid and its billing data lags by hours — so this is the accurate way to attribute spend to a call.
gemini_upload_fileDescription is built at runtime.
gemini_video_generatecan change or delete dataDescription is built at runtime.
gemini_view_mediaread-onlyReturn a generated image as an inline image block, so you can actually SEE it — from its `r2_key`. The generation tools hand back links, which a model cannot look at; call this to check composition, colour or garbled text before refining, and to inspect an image recovered with gemini_list_recent_media. Costs image tokens on the turns you use it, which is why it is a separate call and not part of every result. Keywords: see the image, view, look at, verify output, check the result, preview.
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 1
- Weekly downloads
- 759
- Last commit
- Oct 20, 2026 (8 days ago)
- Last release
- Oct 20, 2026 (8 days ago)
- Last package publish
- Oct 20, 2026 (8 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.chrischall/gemini-mcp- Version
- 2.4.2
- Auth
- API key
- Packages
- npm @chrischall/gemini-mcp
- License
- MIT
- Repository
- github.com/chrischall/gemini-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from chrischall
- 0.596score
Musescore MCP
chrischall
MuseScore for Claude — search sheet music and read score metadata via your signed-in browser
ConnectorAFreshness: ALocal↓ 257/wkClaude Code +5 - 0.571score
Booli MCP
chrischall
Booli.se real estate for Claude: search listings, sold prices, areas & market stats
ConnectorAFreshness: ALocalRead-only★ 4↓ 467/wkClaude Code +5 - 0.567score
Skylight MCP
chrischall
Skylight Calendar for Claude — family events, chores, and rewards.
ConnectorAFreshness: ALocal★ 16Claude Code +5 - 0.558score
Viator MCP
chrischall
Search Viator tours and activities — products, availability, attractions, destinations.
ConnectorAFreshness: ALocalRead-only★ 1↓ 459/wkClaude Code +5 - 0.557score
Flightaware MCP
chrischall
Live flight tracking and aviation data via FlightAware AeroAPI (flights, airports, alerts).
ConnectorAFreshness: ALocal★ 1↓ 380/wkClaude Code +5 - 0.555score
App Store Connect MCP
chrischall
App Store Connect MCP: apps, TestFlight, reviews, sales reports, and team users.
ConnectorAFreshness: ALocal★ 1↓ 294/wkClaude Code +5
Cite this page
Gemini MCP. Agent Mart. https://agentmart.dev/connectors/chrischall-gemini-mcp (last updated 2026-10-25)