Google Search Console as an SEO copilot for AI.
gsc-mcp connects Search Console to Claude and any MCP client, so you can ask plain-language questions, diagnose indexing, and act on real opportunities — all running locally on your machine.
# add it to Claude Code, then just ask claude mcp add gsc -- npx -y @ajmalaksar/gsc-mcp serve # "which of my pages are losing clicks this month?"
From raw Search Console data to decisions you can act on.
Search Console tells you what is happening. gsc-mcp is being built to also tell you what to change — and help your AI assistant do it with you.
Search analytics, in plain languageAvailable
Clicks, impressions, CTR and position by any dimension and date range — plus top queries and pages.
Opportunity finderAvailable
Striking-distance keywords (positions 5–20) and high-impression / low-CTR pages, ranked with a reason for each.
URL inspectionAvailable
Index status, coverage, canonical, last crawl and rich-result state for any URL — to diagnose why a page is or isn't indexed.
Multi-site, one placeAvailable
Register friendly aliases, switch the active property in conversation, and get a portfolio view across every site you own.
Coverage report, reconstructedRoadmap
The 'Page indexing' buckets Google won't export in bulk — rebuilt URL-by-URL within quota: crawled-not-indexed, discovered, redirects, blocked.
On-page audits with fixesRoadmap
Fetch a live page and get concrete edits — titles, meta, canonical, Open Graph previews, structured data, alt text — not just a red X.
Page speed & Core Web VitalsRoadmap
LCP, INP and CLS from real-user field data via PageSpeed Insights and CrUX, folded into your site's health.
SEO / E-E-A-T / GEO scoresRoadmap
A prioritized 'fix these first' list and a generated report — including readiness to be cited by AI answer engines.
Local dashboardRoadmap
A private dashboard to see coverage, scores and audits at a glance — reading the same data your AI client does.
What's shipped, and what's coming.
Built in public, one phase at a time — Phase 1 is live today.
- Phase 1Shipped
Core Search Console
Search analytics, opportunity finder, URL inspection, sitemaps and multi-site — over MCP and the CLI.
- Phase 2In progress
Coverage reconstruction
Rebuild the 'Page indexing' report Google won't export in bulk — cached, URL-by-URL, within quota.
- Phase 3Planned
On-page audits + page speed
Fetch a live page for concrete fixes (titles, meta, Open Graph, structured data) plus Core Web Vitals from PageSpeed and CrUX.
- Phase 4Planned
Scores & site report
SEO, E-E-A-T and GEO scores with a prioritized, shareable report — your single source of truth.
- Phase 5Planned
Local dashboard
A private dashboard to see coverage, scores and audits at a glance — reading the same data your AI client does.
- Phase 6Planned
One-click onboarding
Hosted 'sign in with Google' and a one-click install, so anyone can connect their sites in seconds.
Your data never leaves your machine.
gsc-mcp runs as a local server. You sign in with your own Google account; the token is stored only on your device. We never receive, store, or see your Search Console data.
- Read-only access — the
webmasters.readonlyscope, nothing more. - OAuth tokens stored locally at
~/.gsc-mcp, never transmitted to us. - No hosted backend, no data warehouse — each user runs their own.
- Open source and MIT licensed — read every line.
Built in public.
Phase 1 is live; coverage reconstruction, on-page audits, scoring and the dashboard are landing next. Follow along or contribute.
Star the repo →