Open source · MIT licensed

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.

View on GitHub Setup Configuration
MCP tools
5
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.

It uses a safe, read-only authentication scope. All analysis logic runs on your own infrastructure or in your local workspace, keeping your search statistics private and secure.

Tools

Exposed Server Capabilities

Five read-only tools to retrieve sitemaps, query analytics, and inspect indexing statuses.

01 get_capabilities

Lists available capabilities and reports whether your Google Search Console connection is currently authenticated.

02 list_sites

Retrieves a list of all Search Console properties the connected Google account has permissions to access.

03 query_search_analytics

Queries search metrics (clicks, impressions, CTR, position) over custom ranges filtered by query, page, device, or country.

04 inspect_url

Fetches live Google URL inspection reports showing indexing status, sitemap inclusion, crawl times, and mobile usability.

05 list_sitemaps

Lists all sitemaps submitted for the property along with submission, crawl status, and detected warning/error counts.

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/mcp

Cursor

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

~/mcp-gsc · deploy 
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
# ... configure D1 database and KV namespaces per SETUP.md
npx wrangler deploy

Star the repo and unlock sitemaps & search queries inside Claude.

MIT licensed. Deploy to Cloudflare Workers in minutes.

View on GitHub