Query search rankings without opening the GSC dashboard

What it does This project is a Model Context Protocol (MCP) adapter for the Google Search Console API. It registers twenty discrete tools—covering property listings, search analytics, URL inspection, and sitemap management—so MCP-compatible clients like Claude Desktop, Cursor, or Codex CLI can fetch live SEO data on your behalf. You ask your assistant a question; it calls the relevant tool and returns impressions, clicks, or indexing status instead of guessing.

The interesting bit The author recently had to remove an isatty check that was silently blocking OAuth browser logins when the server ran as a subprocess inside macOS AI clients—an annoyingly specific fix that signals this is being used in real desktop environments rather than just demoed. Exposing twenty discrete tools instead of one big “fetch everything” endpoint means the AI requests only the data it needs.

Key highlights

• Twenty exposed tools including get_search_analytics, batch_url_inspection, and compare_search_periods.
• Supports both OAuth desktop flow and service-account authentication.
• Distributed via uvx and the Cursor Marketplace for zero-clone installs.
• Optional hosted version adds GA4 integration and one-click sign-in starting at $12/month.
• Destructive actions like site removal are disabled by default behind an GSC_ALLOW_DESTRUCTIVE flag.

Caveats

• You still need to generate OAuth or service-account credentials in Google Cloud Console before the first chat; the AI cannot bypass Google’s bureaucracy.
• The documentation is exhaustive on installation and sparse on what conversational queries look like once connected.
• The recent isatty fix suggests macOS auth was brittle; while resolved, running subprocesses under GUI apps remains a finicky deployment target.

Verdict Worth wiring up if you are an SEO specialist or site operator who already lives inside Claude, Cursor, or another MCP client. Everyone else can probably keep logging into the GSC web UI.