1-Line Quickstart
# ⚡ 1-Line Universal Installer
curl -fsSL https://gsc.builditwithai.xyz/install | bash
# 📦 Run directly via Python (uvx)
uvx google-search-console-mcp
# 📦 Run directly via Node (npx)
npx -y google-search-console-mcp
The Search Console Bridge
Fetches clicks, impressions, CTR, and average position metrics broken down by query, page URL, device type, and country.
Checks Googlebot crawl state, canonical URL selection, mobile usability, and index coverage for any specific page.
Lists submitted sitemaps, inspects XML parse errors, and submits fresh sitemap endpoints programmatically.
Uses standard Google Cloud Service Account JSON credentials or OAuth2 tokens stored strictly on your local machine.
Agent Configuration
Claude Code CLI
claude mcp add gsc -- uvx google-search-console-mcp
Cursor & Google Antigravity (mcp.json)
{
"mcpServers": {
"google-search-console": {
"command": "uvx",
"args": ["google-search-console-mcp"],
"env": {
"GSC_CREDENTIALS_PATH": "/path/to/service-account.json"
}
}
}
}
Tool & Parameter Reference
| Tool Name | Parameters | Description | Return Type |
|---|---|---|---|
get_search_analytics |
site_url, start_date, end_date, dimensions |
Fetches clicks, impressions, CTR, and average position across query/page/device. | JSON |
inspect_url |
site_url, inspection_url |
Checks index status, crawl issues, and canonical URL compliance. | JSON |
list_sites |
(none) | Lists all verified web properties in the connected GSC account. | JSON |
list_sitemaps |
site_url |
Retrieves all submitted sitemaps and their last crawl timestamp. | JSON |
submit_sitemap |
site_url, feedpath |
Submits a fresh XML sitemap endpoint to Googlebot. | JSON |