Google Search
About
Integrates with Google Custom Search API to perform web searches and retrieve formatted results with titles, links, and snippets for research tasks and fact-checking.
Details
- Author
- gradusnikov
- Repository
- gradusnikov/google-search-mcp-server
- GitHub stars
- 6
- Downloads
- 668
- Categories
- Productivity, Developer Tools, Design, AI, Search, Infrastructure, Security, Project Management
Jump to
—
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 SearchCommand (node, npx, python, etc.)mcpArguments-
Argument 1
run -
Argument 2
google_search_mcp_server.py
Environment-
GOOGLE_CSE_ID
your_custom_search_engine_id -
GOOGLE_API_KEY
your_google_api_key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Start the server using MCP:
mcp run google_search_mcp_server.py
or add the server to Claude Desktop app CLAUDE_DIRECTORY/claude_desktop_config.json. For example if you are using Windows Subsystem for Linux (WSL) it may look like this:
"google-search": {
"command": "wsl.exe",
"args": [
"bash",
"-c",
"source /home/[user]/anaconda3/etc/profile.d/conda.sh && conda activate mcp && /home/[user]/anaconda3/bin/mcp run /home/[user]/google-search-mpc-server/google_search_mcp_server.py"
]
},
To install google-search-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @gradusnikov/google-search-mcp-server --client claude
1. Clone the repository:
git clone https://github.com/gradusnikov/google-search-mpc-server.git
cd google-search-mpc-server
2. Install dependencies:
pip install fastmcp google-api-python-client python-dotenv
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"google search": {
"env": {
"GOOGLE_CSE_ID": "your_custom_search_engine_id",
"GOOGLE_API_KEY": "your_google_api_key"
},
"args": [
"run",
"google_search_mcp_server.py"
],
"command": "mcp"
}
}
}Linux
{
"env": {
"GOOGLE_CSE_ID": "your_custom_search_engine_id",
"GOOGLE_API_KEY": "your_google_api_key"
},
"args": [
"run",
"google_search_mcp_server.py"
],
"command": "mcp"
}Macos
{
"env": {
"GOOGLE_CSE_ID": "your_custom_search_engine_id",
"GOOGLE_API_KEY": "your_google_api_key"
},
"args": [
"run",
"google_search_mcp_server.py"
],
"command": "mcp"
}Windows
{
"env": {
"GOOGLE_CSE_ID": "your_custom_search_engine_id",
"GOOGLE_API_KEY": "your_google_api_key"
},
"args": [
"bash",
"-c",
"source /home/[user]/anaconda3/etc/profile.d/conda.sh && conda activate mcp && /home/[user]/anaconda3/bin/mcp run /home/[user]/google-search-mpc-server/google_search_mcp_server.py"
],
"shell": true,
"command": "wsl.exe"
}Google Search MCP Server
A Model Context Protocol (MCP) server that provides Google Custom Search functionality.
Installation
Installing via Smithery
To install google-search-mcp-server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @gradusnikov/google-search-mcp-server --client claude
Manual Installation
1. Clone the repository:git clone https://github.com/gradusnikov/google-search-mpc-server.git
cd google-search-mpc-server
2. Install dependencies:
pip install fastmcp google-api-python-client python-dotenv
Configuration
Create a .env file in the project root with the following variables:
GOOGLE_API_KEY=your_google_api_key
GOOGLE_CSE_ID=your_custom_search_engine_id
To obtain these credentials:
1. Create a Google Cloud project and enable the Custom Search API
2. Generate an API key from the Google Cloud Console
3. Create a Custom Search Engine at https://cse.google.com/cse/all and get its ID
Usage
Start the server using MCP:
mcp run google_search_mcp_server.py
or add the server to Claude Desktop app CLAUDE_DIRECTORY/claude_desktop_config.json. For example if you are using Windows Subsystem for Linux (WSL) it may look like this:
"google-search": {
"command": "wsl.exe",
"args": [
"bash",
"-c",
"source /home/[user]/anaconda3/etc/profile.d/conda.sh && conda activate mcp && /home/[user]/anaconda3/bin/mcp run /home/[user]/google-search-mpc-server/google_search_mcp_server.py"
]
},
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
