Gemini Deep Research MCP

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

Quick Start

# Recommended (zero-install)
uvx gemini-deep-research-mcp

# Or install globally
pip install gemini-deep-research-mcp
gemini-deep-research-mcp

Requires: uv for uvx method

One-Click Install

IDE	Install
Cursor
VS Code
VS Code Insiders

Note: After clicking, replace your-api-key with your Gemini API key. VS Code requires version 1.101+.

Installation Methods

Using uvx (Recommended)

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"
    }
  }
}

Prerequisites

Install uv (required for uvx method)

# 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"

Tools

1. `start_deep_research`

Initiates a deep, multi-step web research job in the background using Google's Deep Research Agent. Returns a job_id, which you can use to check the status of completion using check_deep_research(job_id=...).

Parameter	Type	Required	Default	Description
`prompt`	string	✓	—	Your comprehensive research question or topic

Output	Description
`job_id`	Unique tracking ID for the research job
`status`	Initial job state (e.g. `in_progress`)

2. `check_deep_research`

Checks the status of a Deep Research job using its job_id and returns the complete report once finished.

Parameter	Type	Required	Default	Description
`job_id`	string	✓	—	The research tracking ID from `start_deep_research`
`include_citations`	boolean		`true`	Include source URLs in the report

Output	Description
`job_id`	The tracking ID of the research job
`status`	Exact current job state (`in_progress`, `completed`, `failed`, or `cancelled`)
`report_text`	Synthesized markdown research report (when `completed`)
`uptime`	Elapsed time while the job is in progress, when available
`error`	Failure details, when the API provides them

Configuration

Variable	Required	Default	Description
`GEMINI_API_KEY`	✓	—	Your Gemini API key
`GEMINI_DEEP_RESEARCH_AGENT`		`deep-research-preview-04-2026`	Deep Research agent to use. Set to `deep-research-max-preview-04-2026` for maximum thoroughness, or `deep-research-preview-04-2026` for standard speed.

License

MIT

Metadata

Release files for gemini-deep-research-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gemini-deep-research-mcp 0.2.0
File	Size	Uploaded
gemini_deep_research_mcp-0.2.0.tar.gz	14.5 kB	Aug 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for gemini-deep-research-mcp 0.2.0
File	Interpreter	ABI	Platform	Reset
gemini_deep_research_mcp-0.2.0-py3-none-any.whl 11.0 kB Aug 21, 2026	Python 3	none	any	Details

Total release size: 25.6 kB

Release files / gemini_deep_research_mcp-0.2.0.tar.gz

Download URL	gemini_deep_research_mcp-0.2.0.tar.gz
Size	14.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`22e9a76eabfb17b642e2b514a06c6edf8269c4b929a30170d4374ac06057db8f`
BLAKE2b-256 checksum How to use checksums	`4049c43b055b169def5cb6832414d9cff37af7a9bb85071239147a9e1b124556`
Upload date	Aug 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bharatvansh/gemini-deep-research-mcp
Publishing commit: github.com/bharatvansh/gemini-deep-research-mcp/tree/b8f2801865f0f1802d77fcf222d1fd9f3ab2dade

Workflow

Publishing configuration: github.com/bharatvansh/gemini-deep-research-mcp/blob/b8f2801865f0f1802d77fcf222d1fd9f3ab2dade/.github/workflows/publish.yml
Publishing logs: github.com/bharatvansh/gemini-deep-research-mcp/actions/runs/32450112022/attempts/1

Artifact

Subject: gemini_deep_research_mcp-0.2.0.tar.gz
SHA-256 checksum: 22e9a76eabfb17b642e2b514a06c6edf8269c4b929a30170d4374ac06057db8f Verifying attestations

Release files / gemini_deep_research_mcp-0.2.0-py3-none-any.whl

Download URL	gemini_deep_research_mcp-0.2.0-py3-none-any.whl
Size	11.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c5193de736406ddc1c4efd5fcabc4c49ff590cda2a2a3e845778b8e741d604b9`
BLAKE2b-256 checksum How to use checksums	`0b9165e04394ee7b2617187260067e2b206ec281721605ea2c9eb390b9699c05`
Upload date	Aug 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/bharatvansh/gemini-deep-research-mcp
Publishing commit: github.com/bharatvansh/gemini-deep-research-mcp/tree/b8f2801865f0f1802d77fcf222d1fd9f3ab2dade

Workflow

Publishing configuration: github.com/bharatvansh/gemini-deep-research-mcp/blob/b8f2801865f0f1802d77fcf222d1fd9f3ab2dade/.github/workflows/publish.yml
Publishing logs: github.com/bharatvansh/gemini-deep-research-mcp/actions/runs/32450112022/attempts/1

Artifact

Subject: gemini_deep_research_mcp-0.2.0-py3-none-any.whl
SHA-256 checksum: c5193de736406ddc1c4efd5fcabc4c49ff590cda2a2a3e845778b8e741d604b9 Verifying attestations