# Gemini MCP Server
A Model Context Protocol (MCP) server for Google Gemini API integration with Claude Code. Provides text generation, image analysis, creative brainstorming, multi-turn chat, and AI image generation.
## Features
| Tool | Description |
|------|-------------|
| `gemini_generate` | Generate text content (writing, analysis, code) |
| `gemini_analyze_image` | Analyze images with vision capabilities |
| `gemini_brainstorm` | Creative brainstorming for zines, articles, content |
| `gemini_chat` | Multi-turn conversations with memory |
| `gemini_list_conversations` | List active chat sessions |
| `gemini_clear_conversation` | Clear a chat session |
| `gemini_zine_page` | Generate zine page content with layout suggestions |
| `gemini_generate_image` | Generate images using Gemini's image models |
## Setup
### 1. Clone the repository
```bash
git clone https://github.com/jeffemmett/gemini-mcp.git ~/.claude/mcp-servers/gemini
cd ~/.claude/mcp-servers/gemini
npm install
```
### 2. Get a Gemini API Key
1. Go to [Google AI Studio](https://aistudio.google.com/apikey)
2. Create a new API key
3. Copy the key
### 3. Set your API key
Add to your shell profile (`~/.bashrc`, `~/.zshrc`, or `~/.config/fish/config.fish`):
```bash
# Bash/Zsh
export GEMINI_API_KEY="your_api_key_here"
# Fish
set -gx GEMINI_API_KEY "your_api_key_here"
```
Then reload your shell or run `source ~/.bashrc`.
### 4. Configure Claude Code
Add to your project's `.mcp.json` or global MCP config:
```json
{
"mcpServers": {
"gemini": {
"command": "node",
"args": ["/path/to/.claude/mcp-servers/gemini/index.js"],
"env": {
"GEMINI_API_KEY": "${GEMINI_API_KEY}"
}
}
}
}
```
Replace `/path/to/` with your actual home directory path (e.g., `/home/username/` or `/Users/username/`).
## Optional Configuration
### Output Directory
Generated images and saved outputs go to `~/Documents/gemini-output/` by default. Override with:
```bash
export GEMINI_OUTPUT_DIR="/your/preferred/path"
```
## Usage Examples
Once configured, the tools are available in Claude Code:
**Text Generation:**
```
Use gemini_generate to write a haiku about programming
```
**Image Analysis:**
```
Use gemini_analyze_image to describe /path/to/image.jpg
```
**Creative Brainstorming:**
```
Use gemini_brainstorm for a zine about urban gardening with punk style
```
**Image Generation:**
```
Use gemini_generate_image to create a collage-style illustration of a mushroom forest
```
## Models Used
- **Text**: `gemini-1.5-flash` (default), `gemini-1.5-pro`, `gemini-2.0-flash-exp`
- **Images**: `gemini-2.0-flash-exp-image-generation`
## License
MIT
