Connect Google Search Console to MCP clients such as Claude Desktop, Cursor, and Codex CLI. This lets your AI assistant read search performance, find SEO opportunities, and diagnose page indexing issues.
You do not need to remember tool parameters. In most cases, you can paste a site or page URL into the chat, and the AI client will match it to the right Search Console property before querying data.
Google Search Console MCP Server
Sterne
19
Tools
—
Uptime
—
What It Can Do
Generate SEO weekly reports with clicks, impressions, CTR, average position, and trend changes.
Find pages with high impressions but low CTR, then suggest title and snippet improvements.
Show which search queries bring traffic to a specific page.
Compare performance before and after a redesign, migration, or content update.
Check whether a page is indexed by Google, including canonical, robots, crawl, and rich results details.
This project only reads and analyzes Search Console data. It does not add or remove sites, and it does not submit or delete Sitemaps.
For AI Coding Agents
Use this flow when you operate the MCP server from an AI agent:
Call get_capabilities to confirm that the server is reachable and authenticated.
Call list_properties before any site-specific request. Use the exact site_url it returns; do not infer or rewrite Search Console property strings.
For traffic and ranking questions, use Search Analytics tools such as get_performance_overview, get_search_analytics, get_search_by_page_query, compare_search_periods, or get_advanced_search_analytics.
For indexing, canonical, robots, crawl, or rich results questions, use URL Inspection tools such as inspect_url_enhanced, batch_url_inspection, or check_indexing_issues.
Sort or rank returned Search Analytics rows locally in the agent when needed. The Search Console API does not support arbitrary server-side metric sorting.
Treat URL Inspection results as Google's indexed-view data, not as a live crawl of the current page.
Requirements
You need:
Node.js 20 or newer.
A Google Cloud project with the Search Console API enabled.
Access to the target site in Google Search Console.
Either an OAuth Desktop Client JSON file or a Service Account JSON key.
Installation
Using npm:
npm install
npm run build
Or using pnpm:
pnpm install
pnpm build
Run in development mode:
npm run dev
Run the built server:
npm start
The built entry point is dist/index.js. When installed as a package, the binary name is google-search-console-mcp.
Authentication
OAuth
OAuth is the recommended option for local use because it authorizes with your own Google account.
Complete the OAuth consent screen setup when prompted, then choose Desktop app as the client type.
Download the client secrets JSON and keep it in a stable location, such as ~/Documents/client_secrets.json.
Start the server with the client secrets file:
GSC_OAUTH_CLIENT_SECRETS_FILE=/absolute/path/to/client_secrets.json npm run dev
The first tool call starts the browser-based Google sign-in flow. After authorization succeeds, the token is cached under google-search-console-mcp/token.json in your system user config directory, so later runs can reuse it. Set GSC_CONFIG_DIR if you want to use a different cache directory.
Service Account
Service Accounts are a better fit for automation, server deployments, and shared team setups.
From the Service Account's Keys tab, create a new JSON key and download it.
Store the JSON key somewhere stable, such as ~/Documents/service_account.json.
In Search Console, add the Service Account email to the target property with Full access from Settings -> Users and permissions.
Start the server with Service Account-only auth:
GSC_CREDENTIALS_PATH=/absolute/path/to/service_account.json GSC_SKIP_OAUTH=true npm run dev
If you use a Domain property, the user or Service Account must be explicitly added to the sc-domain:example.com property.
Authentication Order
By default, the server tries OAuth first. If OAuth fails and GSC_CREDENTIALS_PATH is set, it falls back to the Service Account.
Set GSC_SKIP_OAUTH=true to skip OAuth and use only the Service Account.
MCP Client Setup
First, find your Node.js path:
which node
Replace the example paths below with real absolute paths on your machine:
/absolute/path/to/node: the output of which node
/absolute/path/to/google-search-console-mcp/dist/index.js: this project's built entry point
/absolute/path/to/client_secrets.json: your OAuth Desktop Client JSON file
/absolute/path/to/service_account.json: your Service Account JSON key
Choose the section for your MCP client below: Claude Desktop, Cursor, or Codex CLI. For macOS GUI apps, use the absolute Node.js path instead of just node. After changing the configuration, fully quit and restart the MCP client.
Then list the Search Console properties your account can access:
list_properties
If you call tools directly, use the exact site_url returned by list_properties.
Try This First
In your MCP client, type:
Show the search performance for this site over the last 28 days: https://example.com/
If everything is configured correctly, the AI client will find the Search Console property your account can access, read the data, and summarize the results.
Example Prompts
Generate an SEO weekly report for https://example.com/ over the last 28 days. Include clicks, impressions, CTR, average position, and trend changes.
Find pages on https://example.com/ from the last 28 days that have high impressions but low CTR, then suggest title and meta description improvements.
Analyze which search queries brought traffic to this page over the last 90 days: https://example.com/blog/example-post
Search traffic for https://example.com/ has dropped recently. Help me find the main declining pages and likely causes.
Check whether these pages have indexing, canonical, robots, or crawl issues:
https://example.com/page-1
https://example.com/page-2
https://example.com/page-3
FAQ
The AI Cannot Find My Site
Make sure the Google account you authorized can see the site in Search Console. Domain properties usually look like sc-domain:example.com, while URL-prefix properties usually look like https://example.com/.
I Changed Google Accounts But It Still Fails
Ask the AI client to call:
reauthenticate
This clears the local OAuth token cache and starts a new browser-based authorization flow.
Is URL Inspection A Live Crawl?
No. URL Inspection returns Google's current indexed-view information. It does not represent a real-time crawl of a page you just changed.
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Fragen
Wie installiere ich Google Search Console?
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
Benötigt Google Search Console einen API-Schlüssel?
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Welchen Transport verwendet Google Search Console?
Google Search Console läuft lokal über stdio.
Wann wurde Google Search Console zuletzt geprüft?
Zuletzt geprüft: 2026-10-28. Google Search Console MCP Server