An MCP (Model Context Protocol) server that provides tools to query Google Search Console data from AI assistants like Claude.
- Search Analytics -- Query clicks, impressions, CTR, and position with filtering by query, page, country, device, and date
- URL Inspection -- Check indexation status, crawl info, canonical URLs, mobile usability, and rich results
- Sitemap Management -- List, get details, submit, and delete sitemaps
- Site Listing -- List all verified properties and their permission levels
| Tool | Description | Read-only |
|---|---|---|
gsc_list_sites |
List all verified Search Console properties | Yes |
gsc_search_analytics |
Query search performance data with dimensions and filters | Yes |
gsc_inspect_url |
Inspect a URL's index status, crawl, and rich results | Yes |
gsc_list_sitemaps |
List submitted sitemaps for a property | Yes |
gsc_get_sitemap |
Get details for a specific sitemap | Yes |
gsc_submit_sitemap |
Submit a sitemap (requires GSC_WRITE_ACCESS=true) |
No |
gsc_delete_sitemap |
Delete a submitted sitemap (requires GSC_WRITE_ACCESS=true) |
No |
- Python 3.11+
- uv (recommended) or pip
- Google Cloud credentials with Search Console API access
git clone https://github.com/kn00m1/google-search-console-mcp.git
cd google-search-console-mcp
uv syncThe server tries credentials in this order:
- Cached token (
~/.config/gsc-mcp/token.json) -- from a previous OAuth flow - Application Default Credentials (ADC) -- from
gcloud auth application-default login - OAuth2 browser flow -- using
~/.config/gsc-mcp/client_secrets.json
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/webmasters.readonly- Create an OAuth client ID (Desktop app) in Google Cloud Console
- Download the JSON and save it as
~/.config/gsc-mcp/client_secrets.json - The server will open a browser for consent on first run
Add to ~/.claude/settings.json:
{
"mcpServers": {
"google-search-console": {
"command": "uv",
"args": ["run", "--directory", "/path/to/google-search-console-mcp", "python", "-m", "gsc_mcp.server"],
"env": {
"PATH": "/usr/local/bin:/usr/bin:/bin"
}
}
}
}uv run python -m gsc_mcp.serverThe server communicates over stdio using the MCP protocol.
Set the environment variable to unlock sitemap submit/delete tools:
GSC_WRITE_ACCESS=true uv run python -m gsc_mcp.server- Token files are stored with
0600permissions - API responses are sanitized against prompt injection patterns
- Error messages redact OAuth tokens and API keys
- Write tools (submit/delete sitemap) are disabled by default
MIT