mcp-gsc — the Google Search Console MCP server.
Connect Claude, Cursor, or ChatGPT to your organic Search Console data. Query impressions, top queries, page performance, sitemap health, and URL indexing details with zero API keys or JSON files to manage.
- MCP tools
- 17
- Auth method
- Google OAuth
- Setup time
- ~5 min
- License
- MIT
About
What is mcp-gsc?
mcp-gsc is a self-hostable Model Context Protocol server that bridges your AI client directly with the official Google Search Console API.
Normally, querying sitemap health or downloading keyword performance logs requires downloading CSVs or building custom scripting scripts. With mcp-gsc, you bring your own server instance on Cloudflare Workers, sign in securely via Google OAuth once, and can start asking complex questions to Claude or ChatGPT immediately.
Read-only analytics tools are clearly separated from explicit write tools for properties, sitemaps, and eligible indexing requests. Each instance uses Google OAuth and stores encrypted refresh tokens in its own Cloudflare account, keeping search statistics under the deployer's control.
Tools
Exposed Server Capabilities
Seventeen focused tools cover analytics, URL inspection, sitemaps, indexing, SEO diagnostics, and a weekly performance digest. Write operations are explicit so an assistant can ask for approval before changing Search Console.
get_capabilities Lists available capabilities and reports whether your Google Search Console connection is currently authenticated.
list_sites Retrieves a list of all Search Console properties the connected Google account has permissions to access.
query_search_analytics Queries search metrics (clicks, impressions, CTR, position) over custom ranges filtered by query, page, device, or country.
inspect_url Fetches live Google URL inspection reports showing indexing status, sitemap inclusion, crawl times, and mobile usability.
list_sitemaps Lists all sitemaps submitted for the property along with submission, crawl status, and detected warning/error counts.
add_site Adds a Search Console property to the connected Google account.
delete_site Removes a Search Console property from the connected Google account.
submit_sitemap Submits a sitemap for a Search Console property.
delete_sitemap Removes a submitted sitemap from a Search Console property.
get_sitemap Retrieves detailed status for one submitted sitemap.
identify_quick_wins Finds high-impression queries ranking in positions 8–20 with low click-through rate.
detect_cannibalization Finds queries where multiple pages compete for search visibility.
detect_content_decay Identifies pages with the largest search-click declines between two periods.
request_indexing Requests indexing for an eligible URL through Google's Indexing API.
list_indexed_pages Lists pages that have received Search Console impressions as a practical indexing proxy.
compare_performance Compares clicks, impressions, CTR, and position across two date ranges.
weekly_digest Generates a plain-language weekly SEO report with movers and one recommended action.
Setup
Connect in 30 seconds
Claude Code
Register the worker transport in your CLI:
claude mcp add --transport http gsc \
https://YOUR-WORKER.workers.dev/mcpCursor
Add a new HTTP server in your Cursor settings:
- Name:
gsc - URL:
https://YOUR-WORKER.workers.dev/mcp
Deploy
5-minute self-host on Cloudflare
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
# ... configure KV namespaces and the Durable Object per SETUP.md
npx wrangler deployStar the repo and unlock sitemaps & search queries inside Claude.
MIT licensed. Deploy to Cloudflare Workers in minutes.