Google Search Console MCP Server
Description
# Google Search Console MCP Server A tool for accessing Google Search Console using the Model Context Protocol (MCP) server. ## Features * Retrieve search analytics data (with dimension support) * Detailed data analysis with customizable reporting periods ## Prerequisites *…
About
# Google Search Console MCP Server A tool for accessing Google Search Console using the Model Context Protocol (MCP) server. ## Features * Retrieve search analytics data (with dimension support) * Detailed data analysis with customizable reporting periods ## Prerequisites * Python 3.10 or higher * Google Cloud project…
Details
- Author
- guchey
- GitHub stars
- 3
- Downloads
- 332
- Categories
- Search
Jump to
- Retrieve search analytics with customizable dimensions
- Supports query, page, country, device, and searchAppearance dimensions
- Filter by search type (web, image, video, news)
- Adjustable aggregation type and row limit
- Easy authentication via Google service account credentials
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 Search Console MCP ServerCommand (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
Install with pip install mcp-server-google-search-console and set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of your service account JSON key. Start the server with mcp-server-gsc (or uvx run mcp-server-gsc). Configure Claude Desktop by adding a gsc entry to the mcpServers object, specifying the command and environment variable. Use the search_analytics tool with required parameters siteUrl, startDate, and endDate.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"google search console mcp server": {
"mcp-server-google-search-console": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"mcp-server-google-search-console": {
"command": "uv",
"args": [
"venv"
]
}
}Google Search Console MCP Server
A tool for accessing Google Search Console using the Model Context Protocol (MCP) server.
Features
Retrieve search analytics data (with dimension support)
Detailed data analysis with customizable reporting periods
Prerequisites
Python 3.10 or higher
Google Cloud project with Search Console API enabled
Service account credentials with access to Search Console
Installation
pip install mcp-server-google-search-console
Or install from source:
git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .
Setting Up Development Environment (uv)
This project uses uv for faster package management and installation.
Installing uv and uvx
First, install uv and uvx:
pip install uv uvx
Creating and Managing Virtual Environments
To create a new virtual environment using uv:
uv venv
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
Installing Dependencies
After cloning the repository, install dependencies:
git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .
To install the MCP package separately:
pip install "mcp[cli]"
Installing Development Dependencies
To install additional tools needed for development, run:
pip install -e ".[dev]"
Authentication Setup
To obtain Google Search Console API credentials:
1. Access the Google Cloud Console
2. Create a new project or select an existing one
3. Enable the API:
Go to "APIs & Services" > "Library"
Search for and enable "Search Console API"
4. Create credentials:
Go to "APIs & Services" > "Credentials"
Click "Create Credentials" > "Service Account"
Enter service account details
Create a new key in JSON format
The credentials file (.json) will be automatically downloaded
5. Grant access:
Open Search Console
Add the service account email address (format: name@project.iam.gserviceaccount.com) as a property administrator
Usage
Set an environment variable to specify the path to your Google Search Console credentials file:
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json
Starting the MCP Server
Standard Method
mcp-server-gsc
Using uvx
With uvx, you can automate virtual environment and package installation:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
