gemini — Claude Code MCP server: features and setup
Adds Gemini tools for image generation and editing, video, SVG, chat, and Google Search-grounded research. Use it to run these tasks from your coding assistant.
claude mcp add gemini -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @houtini/gemini-mcpWhat gemini does
This MCP server connects Gemini models to an agent. Its tools include image generation and editing, video creation with Veo 3.1, SVG and HTML page generation, chat, and deep research grounded in Google Search. In Claude Desktop, results can appear inline through MCP Apps.
You need a Gemini API key and npx to run it. The setup command passes the key as GEMINI_API_KEY. Check the model costs: some defaults for chat, landing pages, and image analysis are paid, so requests using those models can fail with a free key unless you select a free model.
What it helps with
- generate an image from a prompt
- edit an image with text instructions
- create a video from a starting frame
- produce an SVG diagram for a project
- research a topic using Google Search
Example prompts for the agent
- Generate an image from this description and use Google Search for current facts.
- Edit this image: change the scene to daylight and alter the details’ color.
- Create an SVG diagram of this service’s architecture.
How to install gemini
Platform CLI
claude mcp add gemini -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @houtini/gemini-mcpReplace <…> with your own values
Platform CLI
codex mcp add gemini --env GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @houtini/gemini-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"gemini": {
"command": "npx",
"args": [
"-y",
"@houtini/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"gemini": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@houtini/gemini-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> gemini npx -y @houtini/gemini-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gemini
How do I install gemini in Claude Code?
Pass your Gemini API key with this command: claude mcp add gemini -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y @houtini/gemini-mcp.
What does gemini do?
It connects Gemini tools for chat, Google Search-grounded research, image work, video, and SVG generation to your agent.
What does gemini require to run?
You need a Gemini API key and npx. Some default models are paid, so calls using them can fail with a free key.
