mcp-gemini-deep-research

MCP Server for Google Gemini Deep Research via live Chrome cookies (no API key required).

Installation

uvx mcp-gemini-deep-research

Or install globally:

pip install mcp-gemini-deep-research

Usage

Run as an MCP server (stdio):

mcp-gemini-deep-research

Configure in your MCP client (e.g., Hermes, Cursor, etc.):

{
  "mcpServers": {
    "gemini-deep-research": {
      "command": "uvx",
      "args": ["mcp-gemini-deep-research"]
    }
  }
}

Requirements

• Python 3.11+

• Google Chrome signed into a Google account with access to Gemini Deep Research

• macOS, Windows, or Linux

How it works

This server uses your live Chrome session cookies (__Secure-1PSID, __Secure-1PSIDTS) to authenticate with Google's Gemini web API — no API key needed. It runs the real autonomous Deep Research agent that plans, searches the web, reads sources, and synthesizes a cited report over several minutes.

Tool

gemini_deep_research(query: str, timeout: int = 600) — Run a deep research investigation. Returns a JSON report with ok, report (markdown), sources, elapsed_s, research_id, report_path, and stalled flag.

License

MIT