Google Search Console MCP Server

@guchey

About Google Search Console MCP Server

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-google-search-console": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Search Console MCP Server?

The Google Search Console MCP Server is a tool that enables AI assistants (via the Model Context Protocol) to retrieve and analyze search performance data from Google Search Console. It is intended for developers and SEO professionals who want to integrate search analytics into AI workflows, providing programmatic access to metrics like clicks, impressions, and rankings.

How to use Google Search Console MCP Server?

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.

Key features of Google Search Console MCP Server

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

Use cases of Google Search Console MCP Server

Automate weekly SEO performance reports using an AI assistant
Query search analytics data by country or device for targeted analysis
Integrate Google Search Console data into chatbot-based analytics dashboards
Analyze search appearance changes (e.g., AMP, video results) over custom date ranges
Extract top queries and pages for a specific property without manual API calls

FAQ from Google Search Console MCP Server

What are the prerequisites?

Python 3.10 or higher, a Google Cloud project with the Search Console API enabled, and a service account with access to Search Console.

How do I authenticate?

Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of your downloaded JSON key from the Google Cloud Console.

What parameters does the `search_analytics` tool require?

siteUrl (site URL), startDate, and endDate (both in YYYY-MM-DD format). Optional parameters include dimensions, type, aggregationType, and rowLimit.

Can I run the server without installing it?

Yes, using uvx run mcp-server-gsc with optional Python version and environment variable flags.

How do I configure Claude Desktop to use this server?

Add a JSON entry to Claude’s MCP configuration with command: "mcp-server-gsc" and the GOOGLE_APPLICATION_CREDENTIALS environment variable. An alternative using uvx is also provided.

Frequently asked questions

What are the prerequisites?

Python 3.10 or higher, a Google Cloud project with the Search Console API enabled, and a service account with access to Search Console.

How do I authenticate?

Set the environment variable `GOOGLE_APPLICATION_CREDENTIALS` to the path of your downloaded JSON key from the Google Cloud Console.

What parameters does the `search_analytics` tool require?

`siteUrl` (site URL), `startDate`, and `endDate` (both in YYYY-MM-DD format). Optional parameters include `dimensions`, `type`, `aggregationType`, and `rowLimit`.

Can I run the server without installing it?

Yes, using `uvx run mcp-server-gsc` with optional Python version and environment variable flags.

How do I configure Claude Desktop to use this server?

Add a JSON entry to Claude’s MCP configuration with `command: "mcp-server-gsc"` and the `GOOGLE_APPLICATION_CREDENTIALS` environment variable. An alternative using `uvx` is also provided.