gemini-mcp
Generate and edit images, video, and music with Google Gemini models via MCP. Use when the user asks to generate, create, or edit images (Gemini / Nano Banana), produce a consistent set of images, compose/blend multiple images, generate a short video (text→video or image→video, via the omni model), or generate music/audio clips (via Lyria). Triggers on phrases like "generate an image of", "edit this image with Gemini", "create a set of consistent images", "make a video of", "generate a video", "generate music", "make a song/audio clip", "use Nano Banana to make", or any request to produce images, video, or music via the Gemini API. Requires the @chrischall/gemini-mcp package installed and the gemini server registered (see Setup below).
Rank
62
Safety
84
Downloads
3.0k
Updated
Oct 9, 2026
Version
2.3.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 3K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 3K downloadsadoption · observed Oct 9, 2026
- Latest release
- 2.3.3release · observed Oct 7, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:gemini-mcp- Install using `clawhub skill install s17cjx1a349nz5apaqp02vgz4h85728z:gemini-mcp` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/chrischall/gemini-mcp before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-gemini-mcp/snapshot"
Documentation
CLAWHUB
153,259 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: gemini-mcp
description: Generate and edit images, video, and music with Google Gemini models via MCP. Use when the user asks to generate, create, or edit images (Gemini / Nano Banana), produce a consistent set of images, compose/blend multiple images, generate a short video (text→video or image→video, via the omni model), or generate music/audio clips (via Lyria). Triggers on phrases like "generate an image of", "edit this image with Gemini", "create a set of consistent images", "make a video of", "generate a video", "generate music", "make a song/audio clip", "use Nano Banana to make", or any request to produce images, video, or music via the Gemini API. Requires the @chrischall/gemini-mcp package installed and the gemini server registered (see Setup below).
---
# gemini-mcp
MCP server for Google Gemini media generation — natural-language **image**, **video**, and **music** creation via the Gemini API (Nano Banana / Nano Banana Pro images, omni video, Lyria music).
- **npm:** [npmjs.com/package/@chrischall/gemini-mcp](https://www.npmjs.com/package/@chrischall/gemini-mcp)
- **Source:** [github.com/chrischall/gemini-mcp](https://github.com/chrischall/gemini-mcp)
## Setup
### Option A — npx (recommended)
Add to `.mcp.json` in your project or `~/.claude/mcp.json`:
```json
{
"mcpServers": {
"gemini": {
"command": "npx",
"args": ["-y", "@chrischall/gemini-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}
```
### Option B — from source
```bash
git clone https://github.com/chrischall/gemini-mcp
cd gemini-mcp
npm install && npm run build
```
Then add to `.mcp.json`:
```json
{
"mcpServers": {
"gemini": {
"command": "node",
"args": ["/path/to/gemini-mcp/dist/index.js"],
"env": {
"GEMINI_API_KEY": "your-api-key-here"
}
}
}
}
```
Or use a `.env` file in the project directory with `GEMINI_API_KEY=<value>`.
### Getting your API key
1. Go to [aistudio.google.com/apikey](https://aistudio.google.com/apikey)
2. Create an API key (requires a Google account)
3. Copy the key and set it as `GEMINI_API_KEY`
Note: Image generation requires a billing-enabled Google Cloud project.
## Environment Variables
| Variable | Required | Description |
|---|---|---|
| `GEMINI_API_KEY` | Yes | Your Google Gemini API key |
| `GEMINI_IMAGE_MODEL` | No | Override the default image model (default: `gemini-3.1-flash-image`) |
| `GEMINI_OUTPUT_DIR` | No | Default directory for saved images (default: current working directory) |
| `GEMINI_INPUT_DIR` | No | Directory to resolve bare input-image filenames against (e.g. point at Cowork's `uploads/` folder so `images: ["house.jpg"]` works) |
## Tools
### Models
| Tool | Description |
|------|-------------|
| `gemini_list_models` | List available Gemini image models and the current default |
**Which model to pick** (per-call `model`, or `GEMINI_IMAGE_MODEL`):
| Model | When to use | Reference-image caps (of 14 max) _meta.json
{
"ownerId": "kn700jq4sjtf2anb0rk3ft4p7n856872",
"slug": "gemini-mcp",
"version": "2.3.3",
"publishedAt": 1791380232402
}skill-card.md
## Description: Helps agents generate and edit images, create short videos, and produce music with Google Gemini models through an MCP server. This skill is ready for commercial/non-commercial use. ## Publisher: [chrischall](https://clawhub.ai/user/chrischall) ### License/Terms of Use: MIT-0 ## Use Case: External users and creative teams use this skill to direct an agent to generate or refine images, videos, and music from prompts and supplied media. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Prompts, media, clipboard images, URLs, and base64 data may be sent to Gemini or a hosted service. Mitigation: Use only content you are authorized to share; avoid sensitive or regulated data without consent and a review of service retention. Risk: Use requires a Gemini API key and media generation may incur charges. Mitigation: Install only from a trusted package source, safeguard the API key, and review billing before generation. ## Reference(s): - [gemini-mcp ClawHub release](https://clawhub.ai/chrischall/skills/gemini-mcp) - [gemini-mcp npm package](https://www.npmjs.com/package/@chrischall/gemini-mcp) - [Google AI Studio API key](https://aistudio.google.com/apikey) ## Skill Output: **Output Type(s):** [Files, Text] **Output Format:** [PNG or JPEG images, MP4 video, MP3 audio, and text responses with file paths and metadata] **Output Parameters:** [1D] **Other Properties Related to Output:** [Generated files may be saved locally or returned inline; responses can include job IDs for asynchronous generation.] ## Skill Version(s): 2.3.3 (source: server-resolved ClawHub release) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/chrischall/skills/gemini-mcp",
"sourceUrl": "https://clawhub.ai/chrischall/skills/gemini-mcp",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T10:26:00.303Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-gemini-mcp/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-gemini-mcp/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T10:26:00.303Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "3K downloads",
"href": "https://clawhub.ai/chrischall/gemini-mcp",
"sourceUrl": "https://clawhub.ai/chrischall/gemini-mcp",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T10:26:00.303Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "2.3.3",
"href": "https://clawhub.ai/chrischall/gemini-mcp",
"sourceUrl": "https://clawhub.ai/chrischall/gemini-mcp",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-07T13:37:12.402Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-gemini-mcp/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-chrischall-gemini-mcp/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 2.3.3",
"description": "gemini-mcp 2.3.3 - Documentation updated in SKILL.md. - Removed skill-card.md file.",
"href": "https://clawhub.ai/chrischall/gemini-mcp",
"sourceUrl": "https://clawhub.ai/chrischall/gemini-mcp",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-07T13:37:12.402Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
