gemini-deep-research-mcp 0.1.1

MCP server exposing Gemini Deep Research (Interactions API) tools

Gemini Deep Research MCP

An MCP server that exposes Gemini's Deep Research Agent for comprehensive web research.

One-Click Install

Cursor

Click the button, then replace your-api-key with your Gemini API key.

---

Installation Methods

Using npx (Node.js)

Requires Node.js 16+ and uv.

npx gemini-deep-research-mcp

VS Code config

{
  "servers": {
    "gemini-deep-research": {
      "command": "npx",
      "args": ["-y", "gemini-deep-research-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop config

{
  "mcpServers": {
    "gemini-deep-research": {
      "command": "npx",
      "args": ["-y", "gemini-deep-research-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

---

Using uvx (Python)

Requires uv.

uvx gemini-deep-research-mcp

VS Code config

{
  "servers": {
    "gemini-deep-research": {
      "command": "uvx",
      "args": ["gemini-deep-research-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop config

{
  "mcpServers": {
    "gemini-deep-research": {
      "command": "uvx",
      "args": ["gemini-deep-research-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

---

Using pip

pip install gemini-deep-research-mcp

VS Code config

{
  "servers": {
    "gemini-deep-research": {
      "command": "gemini-deep-research-mcp",
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop config

{
  "mcpServers": {
    "gemini-deep-research": {
      "command": "gemini-deep-research-mcp",
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

---

Prerequisites

Install uv (required for npx/uvx methods)

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

---

Tool: gemini_deep_research

Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks until research completes (typically 10-20 minutes).

When to use:

• Complex topics requiring multi-source analysis
• Synthesized information from the web
• Fact-checking and cross-referencing

Parameter	Type	Required	Default	Description
prompt	string	✓	—	Your research question or topic
include_citations	boolean		true	Include resolved source URLs

Output	Description
status	completed, failed, or cancelled
report_text	Synthesized research report

Configuration

Variable	Required	Default	Description
GEMINI_API_KEY	✓	—	Your Gemini API key
GEMINI_DEEP_RESEARCH_AGENT		deep-research-pro-preview-12-2025	Model to use

Development

git clone https://github.com/bharatvansh/gemini-deep-research-mcp.git
cd gemini-deep-research-mcp
pip install -e .[dev]
pytest

License

MIT