Google Search Console MCP Server
Provides tools to query Google Search Console data, including search analytics (clicks, impressions, CTR, position), URL inspection, sitemap management, and site listing.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Search Console MCP Server Show me search analytics for last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| List all verified Search Console properties | Yes |
| Query search performance data with dimensions and filters | Yes |
| Inspect a URL's index status, crawl, and rich results | Yes |
| List submitted sitemaps for a property | Yes |
| Get details for a specific sitemap | Yes |
| Submit a sitemap (requires | No |
| Delete a submitted sitemap (requires | 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 syncAuthentication
The server tries credentials in this order:
Cached token (
~/.config/gsc-mcp/token.json) -- from a previous OAuth flowApplication Default Credentials (ADC) -- from
gcloud auth application-default loginOAuth2 browser flow -- using
~/.config/gsc-mcp/client_secrets.json
Quickest setup (ADC)
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/webmasters.readonlyOAuth2 setup (if ADC doesn't cover your scopes)
Create an OAuth client ID (Desktop app) in Google Cloud Console
Download the JSON and save it as
~/.config/gsc-mcp/client_secrets.jsonThe 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.serverThe 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.serverSecurity
Token files are stored with
0600permissionsAPI 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 toolsgsc_get_sitemapARead-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_urlARead-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_sitemapsARead-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_sitesARead-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_analyticsARead-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
Scored across 5 tools
Each tool targets a distinct GSC resource: sites, analytics, URL inspection, and sitemaps (list vs. specific). No functional overlap exists, making tool selection unambiguous.
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.
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.
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
Read-only Google Search Console MCP server for AI assistants.
SEO MCP server: Search Console, GA4, Crawler and AI visibility across 6 AI engines
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
SEO MCP server for keyword research, live SERPs, backlinks, site audits and AI visibility.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for querying Google Search Console data — search analytics, URL inspection, sitemap monitoring, and more — read-only tools for any MCP-compatible AI client.723 PyPIApache 2.0
- AlicenseNot gradedqualityBmaintenanceMCP server for Google Search Console, enabling querying search analytics, URL inspection, sitemap management, and more via natural language.11,133 npm3MIT
- AlicenseAqualityDmaintenanceA lightweight, fast MCP server for Google Search Console. Query search analytics, manage sitemaps, and inspect URLs directly from your AI assistant.713 PyPIApache 2.0
- AlicenseNot gradedqualityDmaintenanceThis 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