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",
          "",
          "",
          "" // optional: true/false, defaults to true
        ]
      }
    }
  }
}

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",
        "",
        "",
        "" // optional flag, true/false, defaults to true
      ],
      "transportType": "stdio"
    }
  }
}

Important Notes

Don't forget to replace `` and `` with your credentials in the configuration above.

You can also provide an optional `` flag (`true` or `false`) as the last argument to control which Google Custom Search endpoint is used. If omitted, it defaults to `true`.

Available Tools

This MCP server provides the following tool:

1. `search`: Search the web with Google Programmable Search Engine

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