Gemini MCP
Formerly Sibyl.
An MCP server for Google's Gemini.
One MCP across the whole generative surface: text, image, video, speech, embeddings, and deep research. Built for personal use, shared openly, not productised.
Gemini MCP is a local Model Context Protocol server wrapping Google's Gemini generative API. It folds the old nano-banana (image) and gemini-deep-research servers into one coherent Gemini surface, and adds text, video, speech and embeddings, so an assistant reaches everything Gemini generates through a single tool set.
Tools
| Tool | What it does |
|---|---|
generate |
Text, code, chat and reasoning with Gemini |
generate_image / edit_image |
Generate or edit images (Nano Banana). Edit takes one or more inputs for compositing and iterative refinement |
generate_video / video_status |
Generate video with Veo. Async: fire, then poll |
speak |
Text to speech with Gemini TTS |
embed |
Embedding vectors for one or more texts |
deep_research / research_get / research_followup |
Fire an autonomous multi-step research task, poll it, and save a cited Markdown report; ask follow-ups without re-running |
Requirements
- Node 18 or newer.
- A Gemini API key from Google AI Studio.
Install
git clone https://github.com/hello-emrah/gemini-mcp.git
cd gemini-mcp
npm install
Wire into Claude
{
"mcpServers": {
"gemini": {
"command": "node",
"args": ["/absolute/path/to/gemini-mcp/index.js"],
"env": { "GEMINI_API_KEY": "your-key" }
}
}
}
Config
| Variable | Purpose |
|---|---|
GEMINI_API_KEY |
Required. Your Gemini API key. |
GEMINI_DEEP_RESEARCH_API_KEY |
Optional. A separate key for the research agent; falls back to GEMINI_API_KEY. |
GEMINI_TEXT_MODEL / GEMINI_IMAGE_MODEL / GEMINI_VIDEO_MODEL / GEMINI_TTS_MODEL / GEMINI_EMBED_MODEL |
Optional model overrides; sensible current defaults otherwise. |
GEMINI_OUTPUT_DIR |
Where research reports and embedding files land by default. |
Design philosophy
The visual mark and the tool itself were built deliberately against the visual language of capitalist software design. No gradients, no neon, no glass, no drop shadows, no isometric stock illustration. Single-shade flat seals in warm, considered colours, ancient-glyph silhouettes, generous whitespace. The mark could be pressed into wax or carved into stone.
This tool is built for personal use and shared openly. It is not productised, monetised, or instrumented. Use it for your own work or fork it for yours.
License
MIT.
