Skip to content
MCP server

Google Search Console

Read-only Search Console data for assistants: queries, indexing, sitemaps

Runs locallyStatus and history
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally
Version
2.1.2
Listing updated
2 days ago

About Google Search Console

Google Search Console is a freemium MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

Search Console reports never add up to the property total, because Google returns only the top rows. The hosted service from Get MCP Ads says so in its answers instead of summing rows, and notes that CTR arrives as a percentage and is not multiplied again. Reports return 1,000 rows by default and up to 25,000.

Two ways to run it are described. The hosted server at a single URL signs in with Google using the read-only webmasters scope and lets you tick which domain or URL-prefix properties the assistant may see. The open-source npm package, @getmcpads/google-search-console-mcp-server, runs locally over stdio with your own OAuth client ID, secret and refresh token, or a short-lived access token.

The README lists 20 read tools and no write tools. A GSC_SITE_URLS setting limits every tool to named properties; it is optional in 2.x and becomes required in 3.0.0. The server needs a recent Node.js 22, 24 or 26 release carrying the October 2026 security fixes.

Install

Run in a terminal

claude mcp add google-search-console --env GSC_CLIENT_SECRET='<GSC_CLIENT_SECRET>' --env GSC_REFRESH_TOKEN='<GSC_REFRESH_TOKEN>' --env GSC_ACCESS_TOKEN='<GSC_ACCESS_TOKEN>' -- npx -y @getmcpads/google-search-console-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-search-console-mcp-server"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "GSC_ACCESS_TOKEN": "<GSC_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-search-console-mcp-server"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "GSC_ACCESS_TOKEN": "<GSC_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-search-console": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-search-console-mcp-server"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "GSC_ACCESS_TOKEN": "<GSC_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-search-console-mcp-server"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "GSC_ACCESS_TOKEN": "<GSC_ACCESS_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-search-console": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-search-console-mcp-server"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
        "GSC_ACCESS_TOKEN": "<GSC_ACCESS_TOKEN>"
      }
    }
  }
}

Configuration

  • GSC_CLIENT_IDOAuth client ID.
  • GSC_CLIENT_SECRETOAuth client secret.
  • GSC_REFRESH_TOKENOAuth refresh token, webmasters.readonly scope.
  • GSC_ACCESS_TOKENShort-lived access token, alternative to the three values above.
  • GSC_SITE_URLDefault property, https://example.com/ or sc-domain:example.com.
  • GSC_SITE_URLSComma-separated Search Console properties every tool is limited to. Optional in 2.x, required in 3.0.0.

What it does

Clicks and impressions by dimension
Reports clicks, impressions, CTR and position by query, page, country and device.
Gained and lost queries
Compares two periods to show which queries gained or lost the most clicks.
Cannibalization check
Finds pages competing for the same queries and groups queries by intent.
URL inspection
Shows whether a page is indexed and when Google last crawled it, for one URL or a list.
Sitemap health
Reports submitted and indexed URLs, errors and changes since the last read.
Search type comparison
Defaults to web search and compares images, video, News and Discover on request.
Property allowlist
Restricts every tool to the Search Console properties you list.

Good for

  • Find which queries lost the most clicks over the last 28 days
  • Spot pages that compete for the same search terms
  • Check indexing status for a batch of URLs
  • Review sitemap errors after a site change
  • Compare Discover or News traffic against web search

Pricing

Freemium, from $39 a month

Hosted: free for 1 account, Pro $39/mo, Team $99/mo; local npm package is free

Prices change. Check getmcpads.com before you buy.

Google Search Console FAQ

Can it change anything in Search Console?

No. The server is read-only, with 20 read tools and no write tools.

How do I authenticate the local package?

Set GSC_CLIENT_ID, GSC_CLIENT_SECRET and GSC_REFRESH_TOKEN with the webmasters.readonly scope, or use a short-lived GSC_ACCESS_TOKEN instead.

Why do query rows not add up to the site total?

Search Console returns only the top of the ranking, so rows by query or page never sum to the property total.

What does the hosted version cost?

The hosted service has a free plan for one account with 200 requests a month, Pro at $39 a month and Team at $99 a month. The npm server is free to run locally.

Is Google Search Console free?

Google Search Console has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.

How do I add Google Search Console to Claude Code?

Run this command in your terminal: claude mcp add google-search-console --env GSC_CLIENT_SECRET='<GSC_CLIENT_SECRET>' --env GSC_REFRESH_TOKEN='<GSC_REFRESH_TOKEN>' --env GSC_ACCESS_TOKEN='<GSC_ACCESS_TOKEN>' -- npx -y @getmcpads/google-search-console-mcp-server

What are the best alternatives to Google Search Console?

The closest alternatives to Google Search Console 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

  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