Skip to content
MCP server

Google Search Console

Google Search Console server with 37 tools, hourly data and multilingual keyword grouping

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.2
Listing updated
1 day ago

About Google Search Console

Google Search Console is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add gsc-mcp-full -- uvx gsc-mcp-full

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gsc-mcp-full": {
      "command": "uvx",
      "args": [
        "gsc-mcp-full"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gsc-mcp-full": {
      "command": "uvx",
      "args": [
        "gsc-mcp-full"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free, MIT licensed

Prices change. Check mamrrez.github.io before you buy.

Google Search Console 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 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. 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
  4. 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
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping