# Google Search Console

> Google Search Console is an open-source MCP server for web search and scraping. Google Search Console server with 37 tools, hourly data and multilingual keyword grouping. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://mamrrez.github.io/gsc-mcp-full/
- **Repository:** https://github.com/mamrrez/gsc-mcp-full
- **MCP Registry name:** io.github.mamrrez/gsc-mcp-full
- **Categories:** web search and scraping, marketing and SEO
- **Listing updated:** 2026-11-16

## About

The standout idea is query grouping that respects scripts. Search Console treats every spelling as a separate query, so a Persian, Arabic, Japanese, Korean or Turkish keyword can show up as several small rows. This server merges the variants first, and builds Unicode-safe regex patterns because RE2's word boundary only handles ASCII, then runs its analyses on the grouped keyword.

It covers all ten live methods of the Search Console API, all six search types and all seven dimensions including hourly. Beyond raw reports it returns finished analysis such as cannibalization, striking-distance keywords, brand versus non-brand and period comparisons, as compact Markdown capped to protect context. Hourly data can be re-cut into your own timezone, and rows can be synced day by day into a local SQLite file to keep history beyond Google's 16 months.

It runs locally from PyPI via uvx, needs your own Google OAuth client, and is read-only until you set GSC_ALLOW_WRITE=1. The README says there is no hosted service, account or telemetry, and the code is MIT licensed.

## Features

- **Every API endpoint:** Covers all search types, dimensions and Search Console methods.
- **Script-aware grouping:** Merges spelling variants in languages like Persian and Japanese.
- **Local history sync:** Keeps data past 16 months in a SQLite file.
- **Your timezone:** Re-cuts hourly data into local days.
- **Built-in analyses:** Cannibalization, striking distance and brand versus non-brand.
- **Read-only default:** Writes need an explicit environment flag.

## Good for

- Find keywords ranking just off page one
- Detect pages competing for the same query
- Compare this quarter with the same one two years ago
- Inspect indexing status for batches of URLs

## Install

### Claude Code (Terminal)

```sh
claude mcp add gsc-mcp-full -- uvx gsc-mcp-full
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gsc-mcp-full": {
      "command": "uvx",
      "args": [
        "gsc-mcp-full"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gsc-mcp-full": {
      "command": "uvx",
      "args": [
        "gsc-mcp-full"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "gsc-mcp-full": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gsc-mcp-full"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gsc-mcp-full": {
      "command": "uvx",
      "args": [
        "gsc-mcp-full"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gsc-mcp-full": {
      "command": "uvx",
      "args": [
        "gsc-mcp-full"
      ]
    }
  }
}
```

## Tools

- `performance_overview`: One-screen summary of totals, trend, top queries and pages, devices and countries
- `query_search_analytics`: Build any Search Console performance report with spelling variants merged

## FAQ

### Is it free?

Yes, it is MIT licensed.

### What credentials do I need?

A Google OAuth client created in Google Cloud Console.

### Can it change my Search Console settings?

Only if you set GSC_ALLOW_WRITE=1; it is read-only by default.

### Where does my data go?

The README says it runs on your machine with no hosted service or telemetry.

### Is Google Search Console free?

Yes. Google Search Console is open source, so you can use and self-host it for free.

### How do I add Google Search Console to Claude Code?

Run this command in your terminal: claude mcp add gsc-mcp-full -- uvx gsc-mcp-full

### What are the best alternatives to Google Search Console?

The closest alternatives to Google Search Console are Scrapling MCP Server, Firecrawl MCP Server, Google Ads + Meta Ads + SEO/GEO MCP, SearXNG Search and Calven.

## 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.
- [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.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.

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