crunchtools avatar

MCP Google Search Console

crunchtools/mcp-google-search-console

Connects Claude to Google Search Console's API with OAuth2 refresh token auth. You get ten tools covering the main GSC workflows: query search analytics for clicks, impressions, CTR, and position data; manage sitemaps (list, submit, delete); inspect URL indexing status; and handle site property administration. Built by crunchtools with security-focused design (credentials as SecretStr, automatic token scrubbing, Pydantic validation). Setup requires a one-time OAuth flow to generate a refresh token, then the server handles access token rotation automatically. Useful when you're building SEO dashboards, automating sitemap submissions, or investigating indexing issues without leaving your chat context.

tools
6
transport
STDIO
last updated
Mar 3, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

GOOGLE_SEARCH_CONSOLE_GET_SITEMAPRetrieves information about a specific sitemap for a site.2 params

Retrieves information about a specific sitemap for a site.

Parameters* required
feedpathstring
The URL of the sitemap to retrieve. For example: https://www.example.com/sitemap.xml
site_urlstring
The site's URL, including protocol. For example: https://www.example.com/
GOOGLE_SEARCH_CONSOLE_INSPECT_URLInspects a URL for indexing issues and status in Google Search Console.4 params

Inspects a URL for indexing issues and status in Google Search Console.

Parameters* required
inspection_urlstring
The URL of the property as defined in Search Console. For example: https://www.example.com/
language_codestring
The language code of the page. For example: en-USdefault: en-US
site_urlstring
The site's URL, including protocol. For example: https://www.example.com/
urlstring
The URL to inspect. For example: https://www.example.com/page
GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPSLists all sitemaps for a site in Google Search Console.2 params

Lists all sitemaps for a site in Google Search Console.

Parameters* required
site_urlstring
The site's URL, including protocol. For example: https://www.example.com/
sitemap_indexstring
The sitemap index to start listing from. Used for pagination.
GOOGLE_SEARCH_CONSOLE_LIST_SITESLists all sites owned by the authenticated user in Google Search Console.

Lists all sites owned by the authenticated user in Google Search Console.

No parameter schema in public metadata yet.

GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERYQueries Google Search Console for search analytics data including clicks, impressions, CTR, and position metrics.10 params

Queries Google Search Console for search analytics data including clicks, impressions, CTR, and position metrics.

Parameters* required
aggregation_typestring
How data is aggregated. Possible values: auto, byPropertydefault: auto
data_statestring
The data state to return. Possible values: final, alldefault: final
dimension_filter_groupsarray
Filters to apply to the dimensions. Each filter group contains dimension filters.
dimensionsarray
The dimensions to group the data by. Possible values: query, page, country, device, date
end_datestring
The end date of the date range for the query, in YYYY-MM-DD format.
row_limitinteger
The maximum number of rows to return. Must be between 1 and 5000.default: 1000
search_typestring
The search type to filter by. Possible values: web, video, image, newsdefault: web
site_urlstring
The site's URL, including protocol. For example: https://www.example.com/
start_datestring
The start date of the date range for the query, in YYYY-MM-DD format.
start_rowinteger
The first row to return from the result set. Used for pagination.default: 0
GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAPSubmits a sitemap to Google Search Console for indexing.2 params

Submits a sitemap to Google Search Console for indexing.

Parameters* required
feedpathstring
The URL of the sitemap to submit. For example: https://www.example.com/sitemap.xml
site_urlstring
The site's URL, including protocol. For example: https://www.example.com/

Sponsors

Readme

mcp-google-search-console-crunchtools

Secure MCP server for Google Search Console. Query search analytics (clicks, impressions, CTR, position), manage sitemaps, inspect URL indexing status, and manage site properties.

CI PyPI License: AGPL v3

Installation

uvx (recommended, zero-install)

claude mcp add mcp-google-search-console-crunchtools \
    --env GSC_CLIENT_ID=your_client_id \
    --env GSC_CLIENT_SECRET=your_client_secret \
    --env GSC_REFRESH_TOKEN=your_refresh_token \
    -- uvx mcp-google-search-console-crunchtools

pip

pip install mcp-google-search-console-crunchtools

Container (Podman/Docker)


View the full README on GitHub

Details

Repository
github.com/crunchtools/mcp-google-search-console
Categories
Search & Web Crawling, Monitoring & Observability
Package
mcp-google-search-console-crunchtools
Transport
STDIO
Registry
MCP registry, active

More from crunchtools

Related Search & Web Crawling MCP servers

View all
1brave avatarBrave Search Mcp Serverbrave/brave-search-mcp-serverBrave Search MCP Server: web results, images, videos, rich results, AI summaries, and more.1.6Kstars
2cotlet-connect avatarGoogle Search Console MCP Server and API by Cotletcotlet-connect/google-search-console-mcpGoogle Search Console website search performance monitoring MCP server: request indexing.0stars
3firecrawl avatarFirecrawl MCP Serverfirecrawl/firecrawl-mcp-serverFirecrawl, the context API for AI agents: search, scrape, interact with the web, plus paper search.7.8Kstars
4pollinations avatarExa Searchpollinations/pollinationsSearch the live web and fetch clean content from source pages.5.3Kstars
5devshero avatarShadowCrawldevshero/shadowcrawlStealth scraping & search. Bypasses Cloudflare, DataDome & LinkedIn via Cyborg HITL approach.66stars
6pipeworx-io avatarFirecrawlpipeworx-io/mcp-firecrawlFirecrawl MCP — wraps the Firecrawl API (firecrawl.dev) for web scraping / crawling / search…1stars