Google Pse MCP

🚀 Google Programmable Search Engine (PSE) MCP Server

A Model Context Protocol (MCP) server for the Google Programmable Search Engine (PSE) API. It provides tools for web searching via Google Custom Search engine, making them accessible to MCP-compatible clients like VSCode, Copilot, and Claude Desktop.

🚀 Quick Start

This MCP server allows you to use Google Programmable Search Engine through MCP-compatible clients, enabling web searches within your development environment.

📦 Installation

You don't need to clone this repository manually or run installation commands. Just add the following configuration to your MCP client, and it will automatically install and launch the server as required.

VS Code Copilot Configuration

Open the Command Palette → Preferences: Open Settings (JSON), then add:

settings.json

{
  // Other settings...
  "mcp": {
    "servers": {
      "google-pse-mcp": {
        "command": "npx",
        "args": [
          "-y",
          "google-pse-mcp",
          "https://www.googleapis.com/customsearch",
          "<api_key>",
          "<cx>"
        ]
      }
    }
  }
}

Cline MCP Configuration Example

If you're using Cline, add the following to your cline_mcp_settings.json (usually located in your VSCode global storage or Cline config directory):

• macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "google-pse-mcp": {
      "disabled": false,
      "timeout": 60,
      "command": "npx",
      "args": [
        "-y",
        "google-pse-mcp",
        "https://www.googleapis.com/customsearch",
        "<api_key>",
        "<cx>"
      ],
      "transportType": "stdio"
    }
  }
}

⚠️ Important Note

Don't forget to replace <api_key> and <cx> with your credentials in the above configuration.

✨ Features

This MCP server offers the following tool:

1. search: Search the web using Google Programmable Search Engine

   • Parameters:
     • q (string, required): Search query
     • page (integer, optional): Page number
     • size (integer, optional): Number of search results to return per page (1 - 10)
     • sort (string, optional): Sort expression (only 'date' is supported)
     • safe (boolean, optional): Enable safe search filtering
     • lr (string, optional): Restrict search to a particular language (e.g., lang_en)
     • siteRestricted (boolean, optional): Use the Site Restricted API endpoint

💻 Usage Examples

Basic Usage

# Search for "artificial intelligence"
result = await use_mcp_tool(
    server_name="google-pse-mcp",
    tool_name="search",
    arguments={
        "q": "artificial intelligence",
        "size": 5,
        "safe": True
    }
)

📚 Documentation

Useful Links

• Model Context Protocol Servers
• Google Programmable Search Engine Intro