Skip to main content
Glama
Google Search Console MCP Server

Google Search Console MCP Server

by jcd3dr

Google Search Console MCP Server

An MCP (Model Context Protocol) server that provides tools to query Google Search Console data from AI assistants like Claude.

Features

  • Search Analytics -- Query clicks, impressions, CTR, and position with filtering by query, page, country, device, and date

  • URL Inspection -- Check indexation status, crawl info, canonical URLs, mobile usability, and rich results

  • Sitemap Management -- List, get details, submit, and delete sitemaps

  • Site Listing -- List all verified properties and their permission levels

Related MCP server: mcp-gsc

Tools

Tool

Description

Read-only

gsc_list_sites

List all verified Search Console properties

Yes

gsc_search_analytics

Query search performance data with dimensions and filters

Yes

gsc_inspect_url

Inspect a URL's index status, crawl, and rich results

Yes

gsc_list_sitemaps

List submitted sitemaps for a property

Yes

gsc_get_sitemap

Get details for a specific sitemap

Yes

gsc_submit_sitemap

Submit a sitemap (requires GSC_WRITE_ACCESS=true)

No

gsc_delete_sitemap

Delete a submitted sitemap (requires GSC_WRITE_ACCESS=true)

No

Installation

Prerequisites

  • Python 3.11+

  • uv (recommended) or pip

  • Google Cloud credentials with Search Console API access

Install dependencies

git clone https://github.com/kn00m1/google-search-console-mcp.git
cd google-search-console-mcp
uv sync

Authentication

The server tries credentials in this order:

  1. Cached token (~/.config/gsc-mcp/token.json) -- from a previous OAuth flow

  2. Application Default Credentials (ADC) -- from gcloud auth application-default login

  3. OAuth2 browser flow -- using ~/.config/gsc-mcp/client_secrets.json

Quickest setup (ADC)

gcloud auth application-default login --scopes=https://www.googleapis.com/auth/webmasters.readonly

OAuth2 setup (if ADC doesn't cover your scopes)

  1. Create an OAuth client ID (Desktop app) in Google Cloud Console

  2. Download the JSON and save it as ~/.config/gsc-mcp/client_secrets.json

  3. The server will open a browser for consent on first run

Usage

With Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "google-search-console": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/google-search-console-mcp", "python", "-m", "gsc_mcp.server"],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

With any MCP client

uv run python -m gsc_mcp.server

The server communicates over stdio using the MCP protocol.

Enable write access

Set the environment variable to unlock sitemap submit/delete tools:

GSC_WRITE_ACCESS=true uv run python -m gsc_mcp.server

Security

  • Token files are stored with 0600 permissions

  • API responses are sanitized against prompt injection patterns

  • Error messages redact OAuth tokens and API keys

  • Write tools (submit/delete sitemap) are disabled by default

License

MIT

Available Tools

5 tools
gsc_get_sitemapA
Read-onlyIdempotent

Get details for a specific submitted sitemap.

Args: params (SitemapInput): Parameters including: - site_url (str): The GSC property URL - feedpath (str): Full URL of the sitemap

Returns: str: JSON with sitemap details including path, status, content counts, warnings, and errors.

Inputs: params (required). Returns: result

gsc_inspect_urlA
Read-onlyIdempotent

Inspect a URL's indexation status, crawl info, and rich results.

Uses the URL Inspection API to check whether a URL is indexed, its canonical URL, crawl status, mobile usability, and rich results.

Args: params (InspectUrlInput): Parameters including: - inspection_url (str): The fully qualified URL to inspect - site_url (str): The GSC property URL

Returns: str: JSON with inspection results including: - indexStatusResult: verdict, coverageState, crawledAs, lastCrawlTime, pageFetchState - mobileUsabilityResult: verdict, issues - richResultsResult: detectedItems

Inputs: params (required). Returns: result

gsc_list_sitemapsA
Read-onlyIdempotent

List all submitted sitemaps for a verified property.

Args: params (SiteInput): Parameters including: - site_url (str): The GSC property URL

Returns: str: JSON with list of sitemaps, each containing: - path (str): Sitemap URL - lastSubmitted (str): Last submission timestamp - isPending (bool): Whether sitemap is pending processing - isSitemapsIndex (bool): Whether it's a sitemap index - type (str): Sitemap type - lastDownloaded (str): Last download timestamp - warnings (int): Number of warnings - errors (int): Number of errors

Inputs: params (required). Returns: result

gsc_list_sitesA
Read-onlyIdempotent

List all verified properties in Google Search Console.

Returns a list of sites/properties you have access to, including their permission level and site URL format.

Returns: str: JSON with list of verified sites, each containing: - siteUrl (str): The site URL - permissionLevel (str): Your access level (siteOwner, siteFullUser, etc.)

Inputs: no named parameters. Returns: result

gsc_search_analyticsA
Read-onlyIdempotent

Query search performance data (clicks, impressions, CTR, position).

Returns search analytics data for a verified property, with optional grouping by dimensions (query, page, country, device, date) and filtering.

Args: params (SearchAnalyticsInput): Query parameters including: - site_url (str): The GSC property URL - start_date (str): Start date YYYY-MM-DD - end_date (str, optional): End date YYYY-MM-DD, defaults to today - dimensions (list[str], optional): Group by query/page/country/device/date - row_limit (int, optional): Max rows 1-25000, default 100 - start_row (int, optional): Pagination offset - search_type (str, optional): web/image/video/news/discover - dimension_filters (list[dict], optional): Filters for dimensions

Returns: str: JSON with rows containing clicks, impressions, ctr, position, and dimension keys. Includes metadata with total row count.

Inputs: params (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct GSC resource: sites, analytics, URL inspection, and sitemaps (list vs. specific). No functional overlap exists, making tool selection unambiguous.

    Naming Consistency5/5

    All tools follow the gsc_verb_noun pattern in snake_case, with clear verbs like list, search, inspect, and get. The naming is uniform and predictable.

    Tool Count5/5

    Five tools cover the core read-only capabilities of Google Search Console without unnecessary bloat. The scope is well-defined and each tool has a clear purpose.

    Completeness4/5

    The set covers site listing, search analytics, URL inspection, and sitemap details. Minor gaps include no sitemap submission or site management, but these are not critical for typical monitoring and analysis workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for querying Google Search Console data — search analytics, URL inspection, sitemap monitoring, and more — read-only tools for any MCP-compatible AI client.
      7
      23 PyPI
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Google Search Console, enabling querying search analytics, URL inspection, sitemap management, and more via natural language.
      11,133 npm
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A lightweight, fast MCP server for Google Search Console. Query search analytics, manage sitemaps, and inspect URLs directly from your AI assistant.
      7
      13 PyPI
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      This MCP server provides LLMs with programmatic access to Google Search Console data and functionality, including search analytics, sitemap management, site management, and URL inspection.
      MIT