# Gemini Chat MCP
A simple MCP server for chatting with Google Gemini and custom Gems.
## Features
- **Chat with Gemini** - Send messages and receive responses (text + images)
- **Custom Gems support** - Chat with your custom Gems by providing gem_id
- **Model selection** - Choose between Gemini 3 Pro (default) or Gemini 2.5 Flash
- **Auto cookie sync** - Chrome extension automatically syncs cookies
## Installation
```bash
cd C:/Working/gemini-chat-mcp
pip install -e .
```
## Configuration
### Option 1: Chrome Extension (Recommended)
1. Open Chrome and go to `chrome://extensions/`
2. Enable "Developer mode"
3. Click "Load unpacked" and select the `chrome-extension` folder
4. Login to [gemini.google.com](https://gemini.google.com)
5. Click the extension icon to verify cookies are synced
The extension runs a local server on port 52525 that the MCP server uses to fetch cookies automatically.
### Option 2: Manual .env
Copy `.env.example` to `.env` and fill in your cookies:
```
GEMINI_SECURE_1PSID=your_psid_here
GEMINI_SECURE_1PSIDTS=your_psidts_here
```
To get cookies manually:
1. Login to [gemini.google.com](https://gemini.google.com)
2. Open DevTools (F12) → Application → Cookies
3. Copy `__Secure-1PSID` and `__Secure-1PSIDTS` values
## Usage with Amp
Add to your settings.json:
```json
{
"amp.mcpServers": {
"gemini-chat": {
"command": "python",
"args": ["C:/Working/gemini-chat-mcp/src/gemini_chat_mcp/server.py"]
}
}
}
```
Or using module:
```json
{
"amp.mcpServers": {
"gemini-chat": {
"command": "python",
"args": ["-m", "gemini_chat_mcp"],
"cwd": "C:/Working/gemini-chat-mcp"
}
}
}
```
## Tools
### chat
Chat with Gemini. Can generate text and images.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `message` | string | ✅ | Message to send to Gemini |
| `gem_id` | string | ❌ | Custom Gem ID from URL |
| `model` | string | ❌ | `gemini-3-pro` (default) or `gemini-2.5-flash` |
**Example - Basic chat:**
```json
{"message": "Hello, how are you?"}
```
**Example - Chat with custom Gem:**
```json
{
"message": "Hello!",
"gem_id": "10wwoIn-UvdTVzg4rFH3szi4wk8oTo8Cf"
}
```
**Example - Use specific model:**
```json
{
"message": "Explain quantum computing",
"model": "gemini-2.5-flash"
}
```
### set_cookie
Update cookies when they expire.
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `psidts` | string | ✅ | New `__Secure-1PSIDTS` value (starts with `sidts-`) |
| `psid` | string | ❌ | New `__Secure-1PSID` value (starts with `g.a`) |
## How to get Gem ID
From a Gem URL like:
```
https://gemini.google.com/gem/10wwoIn-UvdTVzg4rFH3szi4wk8oTo8Cf
```
The Gem ID is: `10wwoIn-UvdTVzg4rFH3szi4wk8oTo8Cf`
## Project Structure
```
gemini-chat-mcp/
├── src/gemini_chat_mcp/
│ ├── __init__.py
│ ├── __main__.py
│ └── server.py # Main MCP server
├── chrome-extension/ # Cookie sync extension
│ ├── manifest.json
│ ├── background.js
│ ├── popup.html
│ ├── popup.js
│ └── icons/
├── .env.example
├── .gitignore
├── pyproject.toml
└── README.md
```
## License
MIT
