@renzo.johnson/google-search-console-mcp
v26.11.15
Published
Google Search Console MCP server for Claude Code, Cursor and any MCP client. Search Console performance, URL inspection, sitemaps and the Indexing API. mcprush.com-917b2439a4d14523f1903dad
Maintainers
Readme
Google Search Console MCP
Google Search Console MCP server for Claude Code, Cursor and any MCP client. Search Console performance, URL inspection, sitemaps and the Indexing API.
npx -y @renzo.johnson/google-search-console-mcpThe server speaks MCP over stdio. It needs Node.js 22 or newer. Prefer VS Code? Install the Google Search Console MCP extension: it signs you in with a wizard and registers the server with 8 AI agents.
Sign in
The server uses the first credential it finds:
- An OAuth user: set
GOOGLE_OAUTH_CLIENT_ID,GOOGLE_OAUTH_CLIENT_SECRETandGOOGLE_OAUTH_REFRESH_TOKEN. Set all three or none; a partial set stops the server with an error naming what is missing. GOOGLE_APPLICATION_CREDENTIALS: path to a service-account key or anauthorized_userJSON file.- Application Default Credentials from the gcloud CLI:
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/indexing,https://www.googleapis.com/auth/webmastersThe OAuth refresh token (or service account) needs these scopes:
https://www.googleapis.com/auth/indexinghttps://www.googleapis.com/auth/webmasters
Claude Code
Add it from the command line:
claude mcp add google-search-console-mcp -- npx -y @renzo.johnson/google-search-console-mcpOr add it to .mcp.json in your project (or ~/.claude.json for every project).
Cursor
Add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project).
Configuration
Claude Code and Cursor use the same JSON shape:
With Application Default Credentials (gcloud):
{
"mcpServers": {
"google-search-console-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-search-console-mcp"
]
}
}
}With an OAuth user:
{
"mcpServers": {
"google-search-console-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-search-console-mcp"
],
"env": {
"GOOGLE_OAUTH_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
"GOOGLE_OAUTH_CLIENT_SECRET": "your-client-secret",
"GOOGLE_OAUTH_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}With a service-account key:
{
"mcpServers": {
"google-search-console-mcp": {
"command": "npx",
"args": [
"-y",
"@renzo.johnson/google-search-console-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json"
}
}
}
}Available Tools (9)
Search Console (6 tools)
| Tool | What It Does | Example Prompt |
|------|-------------|----------------|
| gsc_list_sites | List the Search Console properties you can access | "Which sites do I have in Search Console?" |
| gsc_search_analytics | Clicks, impressions, CTR and position by query, page, country, device or date | "Top 20 queries for example.com last month" |
| gsc_inspect_url | Index status, last crawl, canonical and rich results for one URL | "Is my pricing page indexed?" |
| gsc_list_sitemaps | List submitted sitemaps and their status | "Show the sitemaps for example.com" |
| gsc_add_site | Add a property (URL prefix or sc-domain:) | "Add sc-domain:example.com to Search Console" |
| gsc_submit_sitemap | Submit a sitemap URL | "Submit https://example.com/sitemap.xml" |
Indexing API (2 tools)
| Tool | What It Does | Example Prompt |
|------|-------------|----------------|
| indexing_notify | Ask Google to crawl (URL_UPDATED) or drop (URL_DELETED) a URL | "Notify Google that this job posting changed" |
| indexing_status | Last notification Google received for a URL | "When did Google last get a notification for this URL?" |
Google honours the Indexing API only for pages with job posting or livestream (BroadcastEvent) markup. For ordinary pages, submit a sitemap or use URL inspection in Search Console. The Indexing API also needs a service account that is an Owner of the property.
Safety
indexing_notify with URL_DELETED asks Google to remove a URL from its index, so it requires confirm: true. The AI agent will be warned and must explicitly confirm before proceeding.
Privacy
The server sends no telemetry. It talks only to Google APIs, with your own credentials.
Links
By Renzo Johnson | MIT License
