# Google Search Console

> Google Search Console is an open-source MCP server for marketing and seo. Google Search Console data and SEO opportunity analysis for AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/pixfrixsystems/search-console-mcp
- **MCP Registry name:** io.github.PixFrixSystems/search-console-mcp
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo), [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

Where most Search Console connectors hand back raw rows, this one adds analysis on top: keywords sitting just below page one, pages that rank but earn few clicks, queries split between several of your pages, and pages that lost traffic along with the reason. Expected click-through is estimated from your own site's data, and every result states caveats such as row caps, sampled data, hidden queries and incomplete days.

It runs on your machine and talks only to Google's API. Access is through a Google service account (added as a user on each property) or your own account via an OAuth browser sign-in. It is read-only unless `GSC_ALLOW_WRITE=true` is set, which enables the sitemap submit and delete tools. Inputs are forgiving: say `example.com` or paste a URL, and omit dates to get the last 28 complete days.

A `doctor` command checks credentials, the API and visible properties. Node.js 22 or newer is required.

## Features

- **Opportunity finders:** Ranked lists of quick wins, CTR gaps and keyword cannibalization.
- **Traffic change analysis:** Compares periods and flags anomalies and declining pages.
- **Indexing checks:** Inspects up to 50 URLs and audits sitemap indexing.
- **Brand split:** Separates branded from non-branded search using your brand terms.
- **Read-only by default:** Sitemap changes need `GSC_ALLOW_WRITE=true`.
- **Setup doctor:** Checks credentials, API access and properties.

## Good for

- Find keywords one push from page one
- Diagnose a sudden drop in organic traffic
- Check whether a page is indexed and why not
- Pick blog posts worth refreshing

## Install

### Claude Code (Terminal)

```sh
claude mcp add search-console-mcp --env GSC_SERVICE_ACCOUNT_JSON='<GSC_SERVICE_ACCOUNT_JSON>' -- npx -y @pixfrix/search-console-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pixfrix/search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pixfrix/search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "search-console-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pixfrix/search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pixfrix/search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pixfrix/search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_JSON": "<GSC_SERVICE_ACCOUNT_JSON>"
      }
    }
  }
}
```

## Tools

- `list_sites`: Lists readable properties.
- `get_performance_overview`: Totals, trend and top queries, pages, countries and devices.
- `search_analytics`: Custom queries over any dimension with filters and paging.
- `compare_periods`: Gainers, decliners, new and lost rows against a prior period.
- `detect_traffic_anomalies`: Flags traffic drops and spikes.
- `get_brand_split`: Splits branded and non-branded traffic.
- `find_quick_wins`: Keywords ranking just below the top results.
- `find_ctr_opportunities`: Well-ranked results with low click-through.
- `find_keyword_cannibalization`: Queries split across several pages.
- `find_declining_pages`: Pages or queries that lost the most clicks.
- `find_content_gaps`: Searches the site appears for without a serving page.
- `analyze_page`: Queries, devices, countries, trend and index status for one URL.
- `inspect_url`: Indexing status of a URL.
- `inspect_urls`: Indexing status of up to 50 URLs.
- `audit_sitemap_indexing`: Share of a sitemap that is indexed.
- `list_sitemaps`: Submitted sitemaps and their errors.
- `submit_sitemap`: Submits a sitemap; needs write enabled.
- `delete_sitemap`: Removes a sitemap; needs write enabled.

## FAQ

### How do I authenticate?

Use a Google service account added to each property, or sign in with your own Google account via `auth login`. The README says both are free.

### Can it change my Search Console?

Only submit and delete sitemaps, and only when `GSC_ALLOW_WRITE=true`. Otherwise it is read-only.

### What does it need to run?

Node.js 22 or newer and a Google account with access to the properties.

### What happens if I omit dates?

It uses the last 28 complete days.

### 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 search-console-mcp --env GSC_SERVICE_ACCOUNT_JSON='<GSC_SERVICE_ACCOUNT_JSON>' -- npx -y @pixfrix/search-console-mcp

### 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, Douyin_TikTok_Download_API and Google Ads + Meta Ads + SEO/GEO MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## 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.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source 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.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [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.

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