# Google Search Console

> Google Search Console is a freemium MCP server for web search and scraping. Read-only Search Console data for assistants: queries, indexing, sitemaps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $39 a month
- **Platforms:** API, CLI, self-hosted, Web
- **Website:** https://www.getmcpads.com/tools/search-console
- **Repository:** https://github.com/get-mcp-ads/google-search-console-mcp-server
- **MCP Registry name:** com.getmcpads/google-search-console
- **Categories:** web search and scraping, marketing and SEO, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/google-search-console-3
