MCP.so
Sign In

Google Search Console MCP server for SEOs

@AminForou

About Google Search Console MCP server for SEOs

Google Search Console Insights with Claude AI for SEOs

Basic information

Category

Search

License

MIT

Runtime

python

Transports

stdio

Publisher

AminForou

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-gsc": {
      "command": "uv",
      "args": [
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

15

Lists all tools and shows auth status — call this first if unsure

Shows all your GSC properties

Details about a specific site

Top queries and pages with clicks, impressions, CTR, position

Summary of site performance

Compare performance between two time periods

Search terms driving traffic to a specific page

Analytics with filters by country, device, query, page

Detailed crawl/index status for a URL

Inspect up to 10 URLs at once

Check multiple URLs for indexing problems

Lists all sitemaps for a site

Detailed sitemap info including errors and warnings

Submit or delete sitemaps

Re-run the OAuth browser login (switch accounts)

Overview

What is Google Search Console MCP server for SEOs?

It connects Google Search Console (GSC) to AI assistants via the Model Context Protocol (MCP), letting you analyze SEO data through natural language. Works with Claude Desktop, Cursor, Codex CLI, Gemini CLI, Antigravity, and any MCP-compatible client.

How to use Google Search Console MCP server for SEOs?

Install using uvx (recommended) or clone the repo. Set up Google API credentials (OAuth or Service Account). Configure your MCP client with the appropriate environment variables and command path. Then ask your AI assistant, for example, “List my GSC properties.” On first OAuth use, a browser window opens for login; after that, the token is cached.

Key features of Google Search Console MCP server for SEOs

  • List all GSC properties with verification and ownership details.
  • Get top queries and pages with clicks, impressions, CTR, position.
  • Compare search performance between two time periods.
  • Inspect single or batch URLs for crawl/indexing status.
  • Manage sitemaps: view, submit, delete.
  • get_capabilities tool lists all available tools and auth status.

Use cases of Google Search Console MCP server for SEOs

  • Check if specific pages have indexing problems and see crawl dates.
  • Track which queries drive traffic and analyze click-through rates.
  • Compare performance across weeks or months to spot trends.
  • Identify patterns by inspecting multiple URLs at once.
  • View and submit sitemaps, checking for errors or warnings.

FAQ from Google Search Console MCP server for SEOs

What tools are available?

Call get_capabilities to see the full list of all 20 tools and current authentication status.

How do I set up OAuth credentials?

Go to Google Cloud Console, enable the Search Console API, create an OAuth client ID (Desktop app), and download the client_secrets JSON. Point the GSC_OAUTH_CLIENT_SECRETS_FILE environment variable to that file.

My tools don't appear in Claude Desktop — what's wrong?

If using the clone method, ensure Python 3.11 or newer (python --version). The uvx method manages Python versions automatically and avoids this issue. Also verify the full path to uvx or the Python interpreter in your config file.

Can I use a service account instead of OAuth?

Yes. Create a service account in Google Cloud, download its JSON key, add the service account email to your GSC property. Set GSC_CREDENTIALS_PATH and GSC_SKIP_OAUTH=true in your client configuration.

How do I reauthenticate or switch Google accounts?

Use the reauthenticate tool, which re-runs the OAuth browser login flow.

Comments

More Search MCP servers