Gemini Google Search MCP Server

A Model Context Protocol (MCP) server that provides AI-powered Google search functionality using Gemini. This server allows you to perform web searches and get synthesized, intelligent responses from current web content.

Features

• Real-time Google search through Gemini AI
• Intelligent synthesis of multiple web sources
• Automatic source attribution and citations
• Integration with Claude Desktop and other MCP clients

Installation

Prerequisites

• Python 3.12 or higher
• uv package manager
• Gemini CLI installed and configured

Setup

1. Clone the repository:

   git clone https://github.com/studykit/mcp-gemini-google-search.git
   cd mcp-gemini-google-search
   

2. Install dependencies:

   uv sync
   

3. Configure Gemini CLI:

   • Install the Gemini CLI following the official guide
   • Set up your API key or configure authentication as needed

4. Test the installation:

   uv run python src/main.py
   

Claude Desktop Integration

To use this MCP server with Claude Desktop, add it to your MCP configuration:

1. Open Claude Desktop Settings

• Open Claude Desktop
• Go to Settings → Developer → Edit Config

2. Add MCP Server Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "gemini-google-search": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-gemini-google-search",
        "run",
        "python",
        "src/main.py"
      ]
    }
  }
}

3. Update Configuration Path

Replace /path/to/mcp-gemini-google-search with the actual path where you cloned this repository.

4. API Key Configuration (Optional)

The GEMINI_API_KEY environment variable is optional. When not provided:

• The server will use the default Gemini CLI configuration
• Gemini CLI will attempt to use its locally configured authentication
• This typically works if you've already run gemini config or have API keys configured through other Gemini CLI setup methods

If you need to provide a specific API key, add the env section:

{
  "mcpServers": {
    "gemini-google-search": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-gemini-google-search",
        "run",
        "python",
        "src/main.py"
      ],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

5. Custom Gemini CLI Path (Optional)

If your Gemini CLI is installed in a non-standard location, you can specify the path:

{
  "mcpServers": {
    "gemini-google-search": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-gemini-google-search",
        "run",
        "python",
        "src/main.py",
        "--gemini-path",
        "/path/to/gemini"
      ]
    }
  }
}

6. Restart Claude Desktop

After saving the configuration, restart Claude Desktop for the changes to take effect.

Usage

Once configured, you can use the Google search functionality in Claude Desktop by asking questions that require current web information:

• "What are the latest developments in AI?"
• "Find recent news about climate change"
• "Search for current Python best practices"

The server will automatically search the web using Gemini and provide synthesized, up-to-date answers with source attribution.

Configuration

Environment Variables

• GEMINI_API_KEY: Your Gemini API key (optional - falls back to Gemini CLI default configuration)

Command Line Arguments

• --gemini-path: Path to the Gemini CLI executable (optional)

License

This project is licensed under the MIT License - see the LICENSE file for details.