About io.github.chrischall/gemini-mcp
io.github.chrischall/gemini-mcp is an MCP server in the Content category: generate and edit images with Google Gemini (Nano Banana / Nano Banana Pro) image models.
Install
claude mcp add io-github-chrischall-gemini-mcp -- npx -y @chrischall/gemini-mcpnpx -y @chrischall/gemini-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (15)
gemini_delete_fileDelete an uploaded file before its ~48h expiry (confirm-gated)
Parameters not published.
gemini_get_resultFetch an async generation started with `async: true` by its `job_id` (status `running` → `done` result). Lets a long generation outlive a host's `tools/call` timeout
Parameters not published.
gemini_get_upload_url*(hosted deployments only)* Mint a short-lived signed PUT URL so a shell can upload a reference image with no auth header; the PUT returns an `r2_key` usable in `images_r2_keys`, `gemini_save_character`, or `gemini_upload_file`
Parameters not published.
gemini_image_editOne-off edits or multi-image composition with a text instruction (for a series of edits, use `gemini_interact`)
Parameters not published.
gemini_image_generateGenerate image(s) from a text prompt
Parameters not published.
gemini_image_setGenerate a master image plus N consistent images referencing it
Parameters not published.
gemini_interactPreferred tool for iterative refinement: multi-turn generation/editing via the Interactions API — chain the returned `interaction_id` via `previous_interaction_id` (or `continue_last: true`)
Parameters not published.
gemini_list_filesList the files currently uploaded under this API key, with MIME types and expiry times
Parameters not published.
gemini_list_modelsList available Gemini image models and the current default
Parameters not published.
gemini_music_generateGenerate music from a text prompt via a Lyria model — `lyria-3-clip-preview` (30s, default), `lyria-3.5` (full-length, vocals) or `lyria-3-pro-preview`; single-turn; written to disk as MP3
Parameters not published.
Show all 15 tools
gemini_sign_media*(hosted deployments only)* Mint a fresh signed URL for generated media from its `r2_key` — an expired link is not a dead end
Parameters not published.
gemini_token_usageToken usage and an estimated USD cost for this session so far. Call it before and after a workflow and subtract to attribute that workflow's spend. Priced per call against each call's own model from a dated rate card (`GEMINI_RATE_CARD` overrides it); there is no account-balance endpoint to read, so this is how spend is attributed
Parameters not published.
gemini_upload_fileUpload an image (or video/audio) to the Gemini Files API once — from a `url`, `data_base64`, or a local `path` — and get a reusable `files/<id>` reference
Parameters not published.
gemini_video_generateGenerate a short video (text→video, image→video, two-still interpolation, `edit` or `extend`) via the Gemini omni model; `resolution` 360p/720p/1080p/4k is the cost lever; written to disk as MP4
Parameters not published.
gemini_view_media*(hosted deployments only)* Return a generated image as an inline image block from its `r2_key`, so a model can actually see what it made before refining it
Parameters not published.
Ask AI
Ask AI about io.github.chrischall/gemini-mcp
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.