mcp-gsc MCP Server

A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude…

Local serverstdio

What is the mcp-gsc MCP Server?

mcp-gsc is an MCP project maintained in the aminforou/mcp-gsc repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /full/path/to/mcp-gsc/.venv/bin/python. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares GSC_OAUTH_CLIENT_SECRETS_FILE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_capabilitiesLists all tools and shows auth status — call this first if unsure
list_propertiesShows all your GSC properties
get_site_detailsDetails about a specific site
get_search_analyticsTop queries and pages with clicks, impressions, CTR, position
get_performance_overviewSummary of site performance
compare_search_periodsCompare performance between two time periods
get_search_by_page_querySearch terms driving traffic to a specific page
get_advanced_search_analyticsAnalytics with filters by country, device, query, page
inspect_url_enhancedDetailed crawl/index status for a URL
batch_url_inspectionInspect up to 10 URLs at once
check_indexing_issuesCheck multiple URLs for indexing problems
get_sitemapsLists all sitemaps for a site
list_sitemaps_enhancedDetailed sitemap info including errors and warnings
manage_sitemapsSubmit or delete sitemaps
reauthenticateRe-run the OAuth browser login (switch accounts)

How to install the mcp-gsc MCP Server

{
  "mcpServers": {
    "gscServer": {
      "command": "/full/path/to/mcp-gsc/.venv/bin/python",
      "args": [
        "/full/path/to/mcp-gsc/gsc_server.py"
      ],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "YOUR_GSC_OAUTH_CLIENT_SECRETS_FILE"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GSC_OAUTH_CLIENT_SECRETS_FILEDeclared in the maintainer’s client configuration.Check documentation