gemini-researcher
CommunityMCP server by capyBearista · updated · ★ 0 · 87 downloads a week
Stateless MCP server that proxies research queries to Gemini CLI, reducing agent context/model usage gemini-researcher is a community project by capyBearista, not verified by a company domain.
Last commit 143 days ago
MPL-2.0: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
GEMINI_Environment variable, secret | Optional | Gemini API key (optional if you already authenticated Gemini CLI via "gemini" login) |
PROJECT_Environment variable | Optional | Override the project root directory used for path validation (defaults to current working directory) |
RESPONSE_Environment variable | Optional | Chunk size threshold (KB) for large responses (default: 10) |
CACHE_Environment variable | Optional | Chunk cache TTL in milliseconds (default: 3600000 / 1 hour) |
DEBUGEnvironment variable | Optional | Enable debug logging (set to "true" or "1") |
GOOGLE_Environment variable | Optional | Vertex AI / Google auth: path to a service account JSON credentials file |
GOOGLE_Environment variable | Optional | Vertex AI / Google auth: GCP project ID (used by some auth configurations) |
VERTEX_Environment variable | Optional | Vertex AI / Google auth: Vertex AI project identifier (used by some auth configurations) |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install gemini-researcher
Built from the published package, never by AIclaude mcp add gemini-researcher -- npx -y gemini-researcherRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add gemini-researcher -- npx -y gemini-researcher{
"mcpServers": {
"gemini-researcher": {
"command": "npx",
"args": [
"-y",
"gemini-researcher"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add gemini-researcher npx -y gemini-researcherGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the gemini-researcher block.
Weekly newsletter
Like gemini-researcher? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to gemini-researcher
All alternatives →Connect AI agents to Exa for web search, content fetching, and multi-step research.
Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.
Visit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Search, read, annotate, and add to your Zotero research library, local or web.
Digital asset manager - upload, organize, search, and generate on-brand images and videos
gemini-researcher: common questions
How do I install gemini-researcher?
In Claude Code run claude mcp add gemini-researcher -- npx -y gemini-researcher. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is gemini-researcher the official server?
gemini-researcher is a community project by capyBearista, not verified by a company domain.
Is gemini-researcher free?
The code is published under the MPL-2.0 licence. The service it connects to may have its own pricing.
Is gemini-researcher safe to use?
It scores 57 of 100. Grades: maintenance C, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to gemini-researcher?
Similar MCP servers: exa, Agent Skills Search Server, brave, Atlassian Rovo MCP Server.
Does gemini-researcher work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
