MCP Hub
Back to servers

Gemini Chat MCP

Provides an interface to interact with Google Gemini AI models and custom Gems, featuring automatic cookie synchronization via a Chrome extension for persistent authentication.

Stars
3
Forks
1
Tools
2
Updated
Dec 21, 2025
Validated
Feb 5, 2026

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

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
  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
  2. Open DevTools (F12) → Application → Cookies
  3. Copy __Secure-1PSID and __Secure-1PSIDTS values

Usage with Amp

Add to your settings.json:

{
  "amp.mcpServers": {
    "gemini-chat": {
      "command": "python",
      "args": ["C:/Working/gemini-chat-mcp/src/gemini_chat_mcp/server.py"]
    }
  }
}

Or using module:

{
  "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.

ParameterTypeRequiredDescription
messagestringMessage to send to Gemini
gem_idstringCustom Gem ID from URL
modelstringgemini-3-pro (default) or gemini-2.5-flash

Example - Basic chat:

{"message": "Hello, how are you?"}

Example - Chat with custom Gem:

{
  "message": "Hello!",
  "gem_id": "10wwoIn-UvdTVzg4rFH3szi4wk8oTo8Cf"
}

Example - Use specific model:

{
  "message": "Explain quantum computing",
  "model": "gemini-2.5-flash"
}

set_cookie

Update cookies when they expire.

ParameterTypeRequiredDescription
psidtsstringNew __Secure-1PSIDTS value (starts with sidts-)
psidstringNew __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

Reviews

No reviews yet

Sign in to write a review