
Mcp Gsc
Wraps the Google Search Console API so you can query search analytics, inspect URL indexing status, and manage sitemaps through Claude. Out of the box you get 7 core tools covering performance queries with dimensions like query, page, country, and device, plus URL inspection and sitemap management. Flip an environment variable to unlock 13 extended tools for things like cannibalization detection, quick wins analysis, and content decay tracking. Write operations for adding sites and submitting sitemaps are gated behind a separate flag. Handles OAuth setup with a CLI wizard, supports service accounts for server environments, and auto-resolves bare domains to your verified GSC properties. Built for SEO work where you want to pull performance data or diagnose indexing issues without leaving your editor.
- GitHub stars
- 1
- tools
- 27
- transport
- STDIO
- last updated
- Mar 23, 2026
Tools
27 toolsPublic tool metadata for what this MCP can expose to an agent.
list_propertiesList all GSC properties with permission levels
List all GSC properties with permission levels
No parameter schema in public metadata yet.
get_property_detailsVerification info, ownership, permissions for a property
Verification info, ownership, permissions for a property
No parameter schema in public metadata yet.
search_analyticsQuery search performance (clicks, impressions, CTR, position) with dimensions, filters, and brand segmentation
Query search performance (clicks, impressions, CTR, position) with dimensions, filters, and brand segmentation
No parameter schema in public metadata yet.
list_sitemapsList sitemaps with status, type, indexed counts, errors
List sitemaps with status, type, indexed counts, errors
No parameter schema in public metadata yet.
get_sitemapDetailed sitemap info with content breakdown
Detailed sitemap info with content breakdown
No parameter schema in public metadata yet.
inspect_urlURL indexing status, crawl info, rich results, canonicals
URL indexing status, crawl info, rich results, canonicals
No parameter schema in public metadata yet.
batch_inspect_urlsInspect up to 10 URLs at once with categorized results
Inspect up to 10 URLs at once with categorized results
No parameter schema in public metadata yet.
export_csvExport full search analytics to a local CSV file (auto-paginates 25K rows per call, up to 1M rows)
Export full search analytics to a local CSV file (auto-paginates 25K rows per call, up to 1M rows)
No parameter schema in public metadata yet.
performance_overviewAggregate metrics + daily trend breakdown
Aggregate metrics + daily trend breakdown
No parameter schema in public metadata yet.
compare_periodsCompare two date ranges with delta calculations
Compare two date ranges with delta calculations
No parameter schema in public metadata yet.
top_moversBiggest gains and drops between periods
Biggest gains and drops between periods
No parameter schema in public metadata yet.
device_country_breakdownPerformance by device and/or country
Performance by device and/or country
No parameter schema in public metadata yet.
quick_winsHigh-impression, low-CTR queries in striking distance (position 4-20)
High-impression, low-CTR queries in striking distance (position 4-20)
No parameter schema in public metadata yet.
cannibalizationMultiple pages competing for the same query
Multiple pages competing for the same query
No parameter schema in public metadata yet.
opportunity_finderEmerging queries, growing impressions with low CTR, declining performers
Emerging queries, growing impressions with low CTR, declining performers
No parameter schema in public metadata yet.
position_trackingPosition changes over time for specific queries/pages
Position changes over time for specific queries/pages
No parameter schema in public metadata yet.
ctr_anomaliesQueries with abnormal CTR relative to position
Queries with abnormal CTR relative to position
No parameter schema in public metadata yet.
content_decayPages/queries with impressions dropping >50% from historical peak
Pages/queries with impressions dropping >50% from historical peak
No parameter schema in public metadata yet.
weekly_seo_reportAll-in-one report: overview + quick wins + top movers
All-in-one report: overview + quick wins + top movers
No parameter schema in public metadata yet.
indexing_coverageBatch URL inspection with categorized indexing status
Batch URL inspection with categorized indexing status
No parameter schema in public metadata yet.
sitemap_healthSitemap error patterns, freshness, indexed vs submitted ratio
Sitemap error patterns, freshness, indexed vs submitted ratio
No parameter schema in public metadata yet.
add_siteAdd a new site to GSC
Add a new site to GSC
No parameter schema in public metadata yet.
delete_siteRemove a site from GSC
Remove a site from GSC
No parameter schema in public metadata yet.
submit_sitemapSubmit a new sitemap
Submit a new sitemap
No parameter schema in public metadata yet.
delete_sitemapRemove/unsubmit a sitemap
Remove/unsubmit a sitemap
No parameter schema in public metadata yet.
request_indexingAsk Google to crawl a URL via the Indexing API
Ask Google to crawl a URL via the Indexing API
No parameter schema in public metadata yet.
get_indexing_statusWhen a URL was last submitted for indexing
When a URL was last submitted for indexing
No parameter schema in public metadata yet.
Sponsors
Readme
mcp-gsc
mcp-gsc
Google Search Console MCP server — query search analytics, inspect URLs, manage sitemaps & more via natural language.
Built with Bun + TypeScript. Works with Claude, Cursor, and any MCP client.
Quick Start
1. Get Credentials
You need OAuth client credentials from Google Cloud Console.
-
Go to Google Cloud Console
-
Create a project (or select existing)
-
Enable the Google Search Console API:
- APIs & Services → Library → search "Google Search Console API" → Enable
-
Configure OAuth consent screen (if not done):
- APIs & Services → OAuth consent screen → External
- Fill in app name + your email, add scope
https://www.googleapis.com/auth/webmasters
-
Create credentials:
- APIs & Services → Credentials → Create Credentials → OAuth client ID
- Application type: Desktop app (allows localhost redirects automatically)
- Download the JSON file
-
Set the credentials path:
Details
- Repository
- github.com/pijusz/mcp-gsc
- Category
- Search & Web Crawling
- Package
mcp-gsc- Transport
- STDIO
- Registry
- MCP registry, active