Google Search Console

Provides access to Google Search Console data via MCP for querying, comparing periods, and visualizing SEO metrics.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "seotesting-com-gsc-mcp-server": {
      "command": "mcp",
      "args": [
        "install",
        "server.py",
        "-v",
        "GOOGLE_APPLICATION_CREDENTIALS=<path to credentials file>"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<path to credentials file>"
      }
    }
  }
}

You can run the Google Search Console data through a dedicated MCP Server to query, compare periods, and visualize SEO metrics such as clicks, impressions, and CTR. This setup lets you connect Google Search Console data to an MCP client, run analytics, and generate actionable insights for your website’s search performance.

How to use

You use the MCP Server by connecting it to an MCP client that can issue data requests and render visualizations. Start by ensuring your Google Cloud credentials are in place, then start the MCP server and enable the Google Search Console analytics tools. Once connected, you can run queries, compare time periods, and generate charts and reports to analyze performance trends, identify optimization opportunities, and track improvements over time.

How to install

Prerequisites you need before installing the MCP Server are Python, uv, and Git (optional for cloning). Ensure Claude Desktop is installed if you plan to integrate with it.

# 1) Clone the repository
git clone https://github.com/seotesting-com/gsc-mcp-server.git
cd gsc-mcp-server

# 2) Create and activate a virtual environment
uv venv
# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

# 3) Install dependencies
uv sync

# 4) Install MCP Server using your credentials file path
mcp install server.py -v GOOGLE_APPLICATION_CREDENTIALS=<path to credentials file>

# Replace <path to credentials file> with the actual path, e.g.
# GOOGLE_APPLICATION_CREDENTIALS=C:\Users\Me\Downloads\credentials.json

Troubleshooting and notes

If you run into issues, restart Claude Desktop, wait a few minutes for the tools to load, and verify that the JSON credentials file is accessible from your chosen location. If you encounter a networking or path-related error, open the Claude Desktop settings under Developer to confirm the MCP configuration and paths, then adjust as needed.

Security and environment

Keep your Google service account JSON file secure and avoid placing it in restricted system folders. Use a user-accessible location such as your Documents or Desktop folder. Ensure the credentials file path is correctly populated in the MCP configuration and environment settings.

Available tools

list_sites

Lists all verified sites in your Google Search Console account.

query_search_analytics

Fetches search analytics data with specified site, date range, dimensions, and search type.

compare_time_periods

Compares performance metrics between a current period and a previous period for a given site and date range.

get_top_performing_content

Retrieves top performing content by a chosen metric (clicks, impressions, CTR, or position) over a date range.

get_search_trends

Retrieves trends over time for a site, grouped by a specified interval (day, week, month).

Built by

VeilStrat

AI signals for GTM teams