Skip to content
Agentmart
Submit a tool

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

IndexedMITLocal (stdio)
Write a review

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.

We use your email only for this newsletter. Privacy

About

Generate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models.

No 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_url
  • gemini_list_characters
  • gemini_list_files
  • gemini_list_models
  • gemini_list_recent_media
  • gemini_list_styles
  • gemini_sign_media
  • gemini_view_media

Write 1 · Create, change, send or run things.

  • gemini_upload_file

Delete 12 · Delete, drop, revoke or wipe things.

  • gemini_delete_character
  • gemini_delete_file
  • gemini_delete_style
  • gemini_get_result
  • gemini_image_edit
  • gemini_image_generate
  • gemini_image_set
  • gemini_interact
  • gemini_music_generate
  • gemini_save_character
  • gemini_save_style
  • gemini_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_MS
  • GEMINI_DEBUG
  • GEMINI_HEARTBEAT_MS
  • GEMINI_IMAGE_MODEL
  • GEMINI_INPUT_DIR
  • GEMINI_OUTPUT_DIR
  • GEMINI_RATE_CARD
  • GEMINI_REFERENCE_DIR
  • GEMINI_TIMEOUT_MS
  • GEMINI_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 data

    Description is built at runtime.

  • gemini_delete_filecan change or delete data

    Description is built at runtime.

  • gemini_delete_stylecan change or delete data

    Description is built at runtime.

  • gemini_get_resultcan change or delete data

    Retrieve 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-only

    Description is built at runtime.

  • gemini_image_editcan change or delete data

    Description is built at runtime.

  • gemini_image_generatecan change or delete data

    Description is built at runtime.

  • gemini_image_setcan change or delete data

    Description is built at runtime.

  • gemini_interactcan change or delete data

    Description is built at runtime.

  • gemini_list_charactersread-only

    List 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-only

    List 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_models

    List 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-only

    List 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-only

    List 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 data

    Description is built at runtime.

Show 7 more tools
  • gemini_save_charactercan change or delete data

    Save 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 data

    Save 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-only

    Mint 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_usage

    Token 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_file

    Description is built at runtime.

  • gemini_video_generatecan change or delete data

    Description is built at runtime.

  • gemini_view_mediaread-only

    Return 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
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 25, 2026

More from chrischall

Cite this page

Gemini MCP. Agent Mart. https://agentmart.dev/connectors/chrischall-gemini-mcp (last updated 2026-10-25)