# mcp-gemini-deep-research

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

## Installation

```bash
uvx mcp-gemini-deep-research
```

Or install globally:
```bash
pip install mcp-gemini-deep-research
```

## Usage

Run as an MCP server (stdio):
```bash
mcp-gemini-deep-research
```

Configure in your MCP client (e.g., Hermes, Cursor, etc.):
```json
{
  "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](https://gemini.google.com/app)
- 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