Gemini Researcher
Stateless MCP server that proxies research queries to Gemini CLI, reducing agent…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.2
- Listing updated
- 5 days ago
About Gemini Researcher
Gemini Researcher is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.
Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage
Install
Run in a terminal
claude mcp add gemini-researcher --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y gemini-researcherAdd to claude_desktop_config.json
{
"mcpServers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gemini-researcher": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gemini-researcher"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Configuration
GEMINI_API_KEYGemini API key (optional if you already authenticated Gemini CLI via "gemini" login)PROJECT_ROOTOverride the project root directory used for path validation (defaults to current working directory)RESPONSE_CHUNK_SIZE_KBChunk size threshold (KB) for large responses (default: 10)CACHE_TTL_MSChunk cache TTL in milliseconds (default: 3600000 / 1 hour)DEBUGEnable debug logging (set to "true" or "1")GOOGLE_APPLICATION_CREDENTIALSVertex AI / Google auth: path to a service account JSON credentials fileGOOGLE_CLOUD_PROJECTVertex AI / Google auth: GCP project ID (used by some auth configurations)VERTEX_AI_PROJECTVertex AI / Google auth: Vertex AI project identifier (used by some auth configurations)
Pricing
Open source
Gemini Researcher FAQ
Is Gemini Researcher free?
Yes. Gemini Researcher is open source, so you can use and self-host it for free.
How do I add Gemini Researcher to Claude Code?
Run this command in your terminal: claude mcp add gemini-researcher --env GEMINI_API_KEY='<GEMINI_API_KEY>' -- npx -y gemini-researcher
What are the best alternatives to Gemini Researcher?
The closest alternatives to Gemini Researcher are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.
Alternatives to Gemini Researcher

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

signafAIde
MCP serverLocal MCP server to set up, verify and check coverage of signed agent action records
Runs locally- 5 tools
- Freemium
- Security

Toolkien
MCP serverOne MCP gateway for all your MCP servers, with code mode, permissions and audit
Not checked yet- 3 tools
- Remote
- Open source
- AI models and LLM tooling
Lugh
MCP serverWrite, check and dry-run Lugh agent programs with policy, budgets and approvals
Runs locally- 5 tools
- Open source
- AI models and LLM tooling
HypePaper
MCP serverResearch papers, benchmarks, citations and topic experts for AI assistants
- 58 tools
- Remote
- Freemium
- AI models and LLM tooling

One compact entry point that finds, describes and runs hundreds of pay-per-call data tools
- 3 tools
- Remote
- Freemium
- Developer tools