Claude MarketplacesSubmit
acamolese avatar

Google Search Console

acamolese/google-search-console-mcp

Connects Claude and other MCP clients directly to Google Search Console via read-only API access. Exposes eight tools covering site lists, performance queries by dimension (query, page, country, device), indexing status checks, URL inspection, and sitemap enumeration. The standout is gsc_audit, which generates a complete brandable HTML report with Chart.js visualizations, automatic issue detection, and a 30/60/90 day SEO roadmap in a single call. Supports stateless deployment through environment variables or XDG config for desktop use. Runs via uvx straight from PyPI with no repository clone required. Useful when you're doing SEO work inside an AI assistant and want to skip the browser loop between Search Console and your chat.

GitHub stars
9
tools
6
auth
Secret needed
transport
STDIO
env vars
6
last updated
Aug 22, 2026
View on GitHub

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

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

GSC_CLIENT_ID

OAuth client ID from a Desktop app credential in Google Cloud Console.

GSC_CLIENT_SECRETsecret

OAuth client secret paired with GSC_CLIENT_ID.

GSC_REFRESH_TOKENsecret

OAuth refresh token, from `mcp-google-search-console auth`.

GSC_SERVICE_ACCOUNT_FILE

Path to a service account JSON key, as an alternative to OAuth.

GSC_REPORT_LANGUAGE

Language of the generated HTML audit report: en or it. Defaults to en.

GSC_DATA_STATE

Default freshness of the data: all (includes today's partial data) or final.

Readme

Google Search Console MCP

English · Italiano

CI PyPI Python License: MIT

Eighteen read-only tools over the Google Search Console API, plus a deterministic white-label HTML audit report an agency can put its own name on and send to a client, in English or Italian.

The generated audit report

Regenerate that report from committed synthetic data, with no credentials:

python scripts/render_sample_report.py --lang en --open

What's new in 4.0

4.0 is about trust: every number the server reports now says what it is based on, and nothing incomplete is presented as a finding.

View the full README on GitHub

Details

Repository
github.com/acamolese/google-search-console-mcp
Website
github.com/acamolese/google-search-console-mcp
Categories
Sales & Marketing, Search & Web Crawling
Package
mcp-google-search-console
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Sales & Marketing MCP servers

View all
1akzar1el avatarWeb Validator by DigestSEOakzar1el/mcp-web-validatorAudit public webpages and supplied markup for HTML, CSS, SEO, JSON-LD, and link issues.9stars
2apideck-libraries avatarMcpapideck-libraries/mcpApideck Unified API MCP — 330 tools across 200+ SaaS connectors (accounting, CRM, HRIS, ATS).0stars
3agencyenterprise avatarAiseo Auditagencyenterprise/aiseo-auditAudit web pages for AI search readiness with evidence-tiered factors and pipeline-stage scores.8stars
4hasdata avatarHasData Glassdoorhasdata/glassdoor-mcpGlassdoor job listings and full postings with company ratings and salary estimates, as JSON.8stars
5cesteral avatarGoogle Ads MCP Servercesteral/mcp-open-advertisingGoogle Ads management — campaign writes, GAQL reporting, bulk mutate, validation, and previews0stars
6sarg338 avatarSteam (read-only)sarg338/steam-mcpRead-only Steam: friends, games, achievements, sales, plus game recommendations and co-op nights.8stars