Google Search Console MCP Server
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
- License
- MIT
Explore
Retrieve search analytics data (with dimension support)
Detailed data analysis with customizable reporting periods
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
Python 3.10 or higher
Google Cloud project with Search Console API enabled
Service account credentials with access to Search Console
This project uses uv for faster package management and installation.
First, install uv and uvx:
pip install uv uvx
To create a new virtual environment using uv:
uv venv
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
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]"
To install additional tools needed for development, run:
pip install -e ".[dev]"
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: [email protected]) as a property administrator
uvx run mcp-server-gsc
uvx run -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json mcp-server-gsc
{
"mcpServers": {
"gsc": {
"command": "mcp-server-gsc",
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
}
}
}
}
{
"mcpServers": {
"gsc": {
"command": "uvx",
"args": ["run", "mcp-server-gsc"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
}
}
}
}
```
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"
]
}
}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: [email protected]) 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.
