About Gemini Deep Research MCP
Gemini Deep Research MCP is an MCP server published by bharatvansh in the Developer Tools category: 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. It has been installed 0 times through Conduid.
The repository has 1 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
npx gemini-deep-research-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Gemini Deep Research MCP
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
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
{
"servers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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"
}
}
}
}
{
"mcpServers": {
"gemini-deep-research": {
"command": "npx",
"args": ["-y", "@bharatvansh/gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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"
}
}
}
}
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"
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"
}
}
}
}
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
{
"servers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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"
}
}
}
}
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Add to ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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"
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "uvx",
"args": ["gemini-deep-research-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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
{
"servers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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"
}
}
}
}
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
Add to ~/.claude/settings.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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"
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"gemini-deep-research": {
"command": "gemini-deep-research-mcp",
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}
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
# 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
README mirrored from the source repository yesterday. The original is authoritative.