What is Google Pse Mcp

google-pse-mcp is a Model Context Protocol (MCP) server designed for the Google Programmable Search Engine (PSE) API, enabling web search functionalities through Google Custom Search.

Use cases

Use cases for google-pse-mcp include enhancing coding environments with search functionalities, integrating web search into AI applications, and providing developers with quick access to online resources.

How to use

To use google-pse-mcp, configure your MCP client (like VSCode or Cline) with the provided settings, including your API key and custom search engine ID (cx). The server will be automatically installed and launched by the client.

Key features

Key features of google-pse-mcp include seamless integration with MCP-compatible clients, the ability to perform web searches using Google Custom Search, and easy configuration without manual installation.

Where to use

google-pse-mcp can be used in software development environments, particularly in applications that require web search capabilities, such as IDEs and AI assistants.

Google Programmable Search Engine (PSE) MCP Server

A Model Context Protocol (MCP) server for the Google Programmable Search Engine (PSE) API. This server exposes tools for searching the web with Google Custom Search engine, making them accessible to MCP-compatible clients such as VSCode, Copilot, and Claude Desktop.

Installation Steps

You do NOT need to clone this repository manually or run any installation commands yourself. Simply add the configuration below to your respective MCP client—your client will automatically install and launch the server as needed.

VS Code Copilot Configuration

Open 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 are using Cline, add the following to your cline_mcp_settings.json (usually found 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 Notes

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

Available Tools

This MCP server provides the following tool:

1. search: Search the web with 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

Example 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
    }
)

Useful Links

• Model Context Protocol Servers
• Google Programmable Search Engine Intro