Google Search Console MCP server for SEOs

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.