Google PSE/CSE
About
A Model Context Protocol (MCP) server providing access to Google Programmable Search Engine (PSE) and Custom Search Engine (CSE).
Details
- Author
- rendyfebry
- GitHub stars
- 11
- Downloads
- 321
- Categories
- Search, Community, Other
Jump to
- Single search tool with rich parameter support
- Configurable result size (1–10 per page)
- Language and safe search filtering
- Optional site‑restricted API endpoint
- Works with any stdio‑based MCP client
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Google PSE/CSECommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
No manual cloning or installation is needed. Add the configuration snippet to your MCP client’s settings (e.g., VS Code’s settings.json or Cline’s cline_mcp_settings.json), replacing <api_key> and <cx> with your Google API key and custom search engine ID. An optional <siteRestricted> flag (true/false) controls the endpoint used.
search
Search the Web using Google Custom Search API
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"google pse/cse": {
"google-pse-mcp": {
"disabled": false,
"timeout": 60,
"command": "npx",
"args": [
"-y",
"google-pse-mcp",
"https://www.googleapis.com/customsearch",
"<api_key>",
"<cx>",
"<siteRestricted>"
],
"transportType": "stdio"
}
}
}
}McpServers
{
"google-pse-mcp": {
"disabled": false,
"timeout": 60,
"command": "npx",
"args": [
"-y",
"google-pse-mcp",
"https://www.googleapis.com/customsearch",
"<api_key>",
"<cx>",
"<siteRestricted>"
],
"transportType": "stdio"
}
}
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>",
"<siteRestricted>" // 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",
"<api_key>",
"<cx>",
"<siteRestricted>" // optional flag, true/false, defaults to true
],
"transportType": "stdio"
}
}
}
Important Notes
Don't forget to replace <api_key> and <cx> with your credentials in the configuration above.
You can also provide an optional <siteRestricted> 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
- 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; defaults to true unless overridden via CLI flag
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
