Gemini Deep Research MCP
This MCP server that brings Gemini's Deep Research Agent to the AI coding assistants. This provides ai assistant with very high quality deep web research. Ai coding assisstant when doing deep research on their own easily fill up their context size, but gemini makes it very very efficient. the only n
Installation
npx gemini-deep-research-mcpAsk AI about Gemini Deep Research MCP
Powered by Claude Β· Grounded in docs
I know everything about Gemini Deep Research MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Gemini Deep Research MCP
An MCP server that exposes Gemini's Deep Research Agent for comprehensive web research.
One-Click Install
| IDE | Install |
|---|---|
| Cursor | |
| VS Code | |
| VS Code Insiders |
Note: After clicking, replace
your-api-keywith your Gemini API key. VS Code requires version 1.101+.
Installation Methods
Using npx (Node.js)
npx @bharatvansh/gemini-deep-research-mcp
VS Code config
{
"servers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Claude Desktop config
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Windsurf config
Add to ~/.codeium/windsurf/mcp_config.json (macOS/Linux) or %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Cline config
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Claude Code config
Add to ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Codex config
Add to ~/.codex/config.toml:
[mcp_servers.gemini-deep-research]
command = "npx"
args = ["-y", "@bharatvansh/gemini-deep-research-mcp"]
[mcp_servers.gemini-deep-research.env]
GEMINI_API_KEY = "your-api-key"
Cursor config
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Antigravity config
Add to your Antigravity mcp_config.json:
{
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/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"
}
}
}
}
Windsurf config
Add to ~/.codeium/windsurf/mcp_config.json (macOS/Linux) or %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Cline config
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Claude Code config
Add to ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Codex config
Add to ~/.codex/config.toml:
[mcp_servers.gemini-deep-research]
command = "uvx"
args = ["gemini-deep-research-mcp"]
[mcp_servers.gemini-deep-research.env]
GEMINI_API_KEY = "your-api-key"
Cursor config
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Antigravity config
Add to your Antigravity mcp_config.json:
{
"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"
}
}
}
}
Windsurf config
Add to ~/.codeium/windsurf/mcp_config.json (macOS/Linux) or %USERPROFILE%\.codeium\windsurf\mcp_config.json (Windows):
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Cline config
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Claude Code config
Add to ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Codex config
Add to ~/.codex/config.toml:
[mcp_servers.gemini-deep-research]
command = "gemini-deep-research-mcp"
[mcp_servers.gemini-deep-research.env]
GEMINI_API_KEY = "your-api-key"
Cursor config
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Antigravity config
Add to your Antigravity mcp_config.json:
{
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
Antigravity
- Open the Agent side panel β click ... β MCP Store
- Search for your MCP server or click Add Custom Server
- Add this configuration to your
mcp_config.json:
{
"gemini-deep-research": {
"command": "uvx",
"args": ["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
