Google Search Console MCP
Local, read-only Google Search Console tools for traffic, indexing and sitemap checks
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 1.1.0
- Listing updated
- 3 days ago
About Google Search Console MCP
Google Search Console MCP is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.
GSC MCP runs on your machine over stdio with Node.js or Bun, and Google API calls are made from there. The default is read-only access limited to the properties you list in GSC_SITE_URLS. Its Quick Connect path ships a shared read-only OAuth client, so you do not need to create a Google Cloud project; custom OAuth or a service-account key are the alternatives, and setup refuses full access for Quick Connect.
The 34 tools compare periods, trace a change back to pages and queries, surface high-impression low-click searches, inspect URLs as Google reports them, list sitemaps with errors and warnings, and export a Markdown report with a limitations section. The README repeatedly states what results do not prove: position is an impression-weighted average, an update overlap is timing only, and URL inspection does not request indexing.
Writing is opt-in. Setting GSC_ACCESS_MODE=full enables URL, batch and sitemap submission. It is an independent open-source project, not a Google product, and needs Node.js 22 or newer.
Install
Run in a terminal
claude mcp add gsc-mcp --env GSC_OAUTH_CLIENT_SECRET='<GSC_OAUTH_CLIENT_SECRET>' -- npx -y @sonnivasquez/gsc-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"gsc-mcp": {
"command": "npx",
"args": [
"-y",
"@sonnivasquez/gsc-mcp"
],
"env": {
"GSC_OAUTH_CLIENT_SECRET": "<GSC_OAUTH_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gsc-mcp": {
"command": "npx",
"args": [
"-y",
"@sonnivasquez/gsc-mcp"
],
"env": {
"GSC_OAUTH_CLIENT_SECRET": "<GSC_OAUTH_CLIENT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gsc-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonnivasquez/gsc-mcp"
],
"env": {
"GSC_OAUTH_CLIENT_SECRET": "<GSC_OAUTH_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gsc-mcp": {
"command": "npx",
"args": [
"-y",
"@sonnivasquez/gsc-mcp"
],
"env": {
"GSC_OAUTH_CLIENT_SECRET": "<GSC_OAUTH_CLIENT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gsc-mcp": {
"command": "npx",
"args": [
"-y",
"@sonnivasquez/gsc-mcp"
],
"env": {
"GSC_OAUTH_CLIENT_SECRET": "<GSC_OAUTH_CLIENT_SECRET>"
}
}
}
}Configuration
GSC_AUTH_MODEoauth or service_account. Unset defaults to service_account. Set oauth for Quick Connect or your own OAuth client.GSC_ACCESS_MODEreadonly or full. full enables gsc_submit_url, gsc_submit_batch, and gsc_submit_sitemap. When unset, legacy GSC_SCOPES and GSC_ENABLE_WRITE apply and writes stay off unless both allow them. Setup refuses full access for Quick Connect.GSC_SITE_URLSProperty allowlist. JSON string array of exact Search Console property ids, a legacy comma-separated list, or all alone (or JSON ["all"]) for every current and future property. Property-scoped tools need an allowlist.GSC_KEY_FILEPath to a service account JSON key. Required when GSC_AUTH_MODE is service_account, which is the default mode.GSC_DATA_DIRLocal state directory for OAuth tokens, datasets and opt-in audit history. Default is ~/.gsc-mcp.GSC_EXPORTSSet to 1 to allow gsc_export_dataset and saved gsc_generate_report files on this machine. Any other value keeps local export disabled.GSC_HISTORYSet to 1 for explicit local gsc_change_impact history actions. Independent of exports; no scheduler or notifications.GSC_OAUTH_SECRETS_FILEOptional path to a Desktop OAuth client secrets JSON file. It takes precedence over GSC_OAUTH_CLIENT_ID and GSC_OAUTH_CLIENT_SECRET. Quick Connect does not need it.GSC_OAUTH_CLIENT_IDOptional OAuth client id. Used with GSC_OAUTH_CLIENT_SECRET when GSC_OAUTH_SECRETS_FILE is unset. Quick Connect does not need it.GSC_OAUTH_CLIENT_SECRETOptional OAuth client secret paired with GSC_OAUTH_CLIENT_ID. Quick Connect does not need it.GSC_SCOPESLegacy scope tier, readonly or full. Ignored when GSC_ACCESS_MODE is set. full alone does not enable writes.GSC_ENABLE_WRITELegacy write opt-in. Set to 1 together with GSC_SCOPES=full when GSC_ACCESS_MODE is unset. Ignored when GSC_ACCESS_MODE is set.
Tools this server provides (6)
Taken from the project documentation; the running server may differ.
- gsc_submit_url
- Submits a URL to Google; needs full access.
- gsc_submit_batch
- Submits several URLs; needs full access.
- gsc_submit_sitemap
- Submits a sitemap; needs full access.
- gsc_genai_conversation_queries
- Reads AI-conversation style queries in Search Console query data.
- gsc_check_update_impact
- Compares a traffic drop window with confirmed ranking updates and reports timing coincidence only.
- gsc_image_page_audit
- Audits image performance on pages.
What it does
- Period comparison
- Compares clicks, impressions and CTR and shows the date window and coverage.
- URL inspection
- Shows Google's reported indexing verdict and canonical.
- Query opportunities
- Finds queries with impressions but few clicks.
- Sitemap review
- Lists registered sitemaps with errors and warnings.
- Weekly reports
- Exports a Markdown report that lists its limitations.
- Property allowlist
- Only properties named in the environment are reachable.
Good for
- Explain a traffic drop by page and query
- Find content-refresh candidates by low CTR
- Check whether a URL is indexed
- Review sitemap errors before debugging pages
- Submit an updated sitemap with full access enabled
Pricing
Open source
Prices change. Check gscmcp.dev before you buy.
Google Search Console MCP FAQ
Do I need a Google Cloud project?
Not for Quick Connect, which uses a shared read-only OAuth client.
Can it change anything?
Only with `GSC_ACCESS_MODE=full`, which enables submission tools.
Is it an official Google product?
No, it is independent and open source.
What does it require?
Node.js 22 or newer and a Search Console property.
Is Google Search Console MCP free?
Yes. Google Search Console MCP is open source, so you can use and self-host it for free.
How do I add Google Search Console MCP to Claude Code?
Run this command in your terminal: claude mcp add gsc-mcp --env GSC_OAUTH_CLIENT_SECRET='<GSC_OAUTH_CLIENT_SECRET>' -- npx -y @sonnivasquez/gsc-mcp
What are the best alternatives to Google Search Console MCP?
The closest alternatives to Google Search Console MCP are Scrapling MCP Server, Firecrawl MCP Server, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP and SearXNG Search.
Alternatives to Google Search Console MCP

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Firecrawl MCP Server
MCP serverMCP server that lets AI agents search, scrape and interact with web pages
- 3 tools
- Remote
- Freemium
- 7.8K GitHub stars
- Web search and scraping

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

SearXNG Search
MCP serverMCP server for web search and page reading through a SearXNG instance
Runs locally- 3 tools
- Open source
- 1.4K GitHub stars
- Web search and scraping

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments