Skip to content
MCP server

Google Search Console MCP

Local, read-only Google Search Console tools for traffic, indexing and sitemap checks

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. MCP 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
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  4. Hosted 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
  5. SearXNG Search

    MCP server

    MCP 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
  6. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments