gsearch-mcp
A community-built MCP server that provides free Google Search grounding with inline citations for MCP-compatible AI tools like Claude Code, Cursor, and Codex. It supports authentication via Google sign-in (Antigravity OAuth) or a Gemini API key, automatically handles rate limit retries, and configures itself via an installer or manual JSON settings.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Perform free Google searches with inline citations
- Ground AI responses in real-time web data
- Integrate search capabilities into Claude Code or Cursor
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
@daanielcruz/gsearch-mcp 1.2.3
{
"version": "1.2.3",
"transport": "stdio",
"identifier": "@daanielcruz/gsearch-mcp",
"registryType": "npm",
"environmentVariables": [
{
"name": "GSEARCH_PROJECT",
"format": "string",
"description": "Override auto-detected Google Cloud project ID (OAuth mode)"
},
{
"name": "GEMINI_API_KEY",
"format": "string",
"description": "Gemini API key (enables direct API key mode, bypasses OAuth)"
},
{
"name": "GSEARCH_API_KEY",
"format": "string",
"description": "Alternate Gemini API key env var (same purpose as GEMINI_API_KEY)"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"gsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@daanielcruz/gsearch-mcp@1.2.3"
],
"env": {
"GSEARCH_PROJECT": "<YOUR_GSEARCH_PROJECT>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GSEARCH_API_KEY": "<YOUR_GSEARCH_API_KEY>"
}
}
}
}Cline
{
"mcpServers": {
"gsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@daanielcruz/gsearch-mcp@1.2.3"
],
"env": {
"GSEARCH_PROJECT": "<YOUR_GSEARCH_PROJECT>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GSEARCH_API_KEY": "<YOUR_GSEARCH_API_KEY>"
}
}
}
}VS Code
{
"servers": {
"gsearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@daanielcruz/gsearch-mcp@1.2.3"
],
"env": {
"GSEARCH_PROJECT": "<YOUR_GSEARCH_PROJECT>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GSEARCH_API_KEY": "<YOUR_GSEARCH_API_KEY>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"gsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@daanielcruz/gsearch-mcp@1.2.3"
],
"env": {
"GSEARCH_PROJECT": "<YOUR_GSEARCH_PROJECT>",
"GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
"GSEARCH_API_KEY": "<YOUR_GSEARCH_API_KEY>"
}
}
}
}Let your agent find its tools
Find servers like gsearch-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.