mcp-gsc

MCP.Pizza Chef: AminForou

Google Search Console holds every query, click and ranking position for your website, but reading it means clicking through dashboards. This connection puts that information in your chat instead: compare this month against last month, find the pages losing traffic, check whether Google has indexed a new post, or submit a sitemap. You sign in with your own Google account, so you only ever see sites you already own. Creating the Google credentials is the fiddly part, and it takes a little patience.

Data
Web/Research

Use This MCP server To

Compare this month's search traffic against last month Find which search terms bring people to one specific page Check whether Google has indexed my newest blog post Spot pages that quietly lost clicks over the past quarter Submit a new sitemap and check it for errors Inspect ten addresses at once for indexing problems

README

Google Search Console MCP Server for SEOs

A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and any other MCP-compatible client.

Skip setup, get more. A more advanced hosted version — one-click sign-in, added GA4 tools. Works with Claude Desktop, Claude Code, Claude.ai, Codex, Cursor, and any MCP client. Only 100 seats. → Advanced GSC MCP (hosted)


What's New

[0.3.3] — July 2026

  • Fixed fresh installs broken by mcp 2.0 — pinned mcp[cli]<2.0.0. The mcp SDK 2.0.0 (released 2026-07-28) removed the mcp.server.fastmcp module, so every fresh uvx mcp-search-console install crashed on startup with ModuleNotFoundError: No module named 'mcp.server.fastmcp'. New installs now resolve a working 1.x SDK again — no --with "mcp<2" workaround needed.

[0.3.2] — April 2026

  • OAuth browser flow fixed for uvx — removed the isatty block that prevented the browser login window from opening when running as an MCP subprocess on macOS. OAuth now works out of the box with uvx, no manual terminal run needed.
  • get_capabilities tool added — call this to get a full list of available tools and current auth status in one shot. Useful when your AI assistant isn't sure what tools are available.
  • Better auth error messages — all tools now tell you exactly what to do when credentials are missing or expired.

What Can This Do?

Property Management

  • See all your GSC properties in one place
  • Get verification details and ownership information
  • Add or remove properties from your account

Search Analytics & Reporting

  • Discover which queries bring visitors to your site
  • Track impressions, clicks, and click-through rates
  • Analyze performance trends and compare time periods
  • Visualize data with charts created by your AI assistant

URL Inspection & Indexing

  • Check if specific pages have indexing problems
  • See when Google last crawled your pages
  • Inspect multiple URLs at once to identify patterns

Sitemap Management

  • View all sitemaps and their status
  • Submit new sitemaps
  • Check for errors or warnings

mcp-gsc FAQ

Which apps does this work in?
Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and other MCP-compatible clients.
Do I need a special key or account?
Nothing to buy, but you do create free Google credentials once in the Google Cloud Console and then sign in with your own Google account.
Can I use this to find search terms I rank for but never noticed?
Yes — ask for your top queries by impressions with few clicks and it pulls them straight from Search Console.
How hard is the setup?
The credentials step is the hardest part. After that a browser window opens once for sign-in and you are done. The project links a step-by-step video.
Can it change my website?
No. It can submit or remove sitemaps and manage properties inside Search Console, but it cannot edit your actual pages.
Does it work for sites I don't own?
No. You only see properties your Google account already has access to.
Is there an easier version?
The author points to a paid hosted version with one-click sign-in if you would rather skip the setup entirely.