# Google Search Console MCP

> Google Search Console MCP is an open-source MCP server for web search and scraping. Search Console clicks, positions, URL inspection and sitemaps for your AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** vscode, CLI
- **Website:** https://renzojohnson.com/contributions/google-search-console-mcp
- **MCP Registry name:** com.renzojohnson/google-search-console-mcp
- **Categories:** web search and scraping, marketing and SEO, analytics and data
- **Listing updated:** 2026-11-15

## About

This is a local server, shipped as a VS Code extension and as an npm package, that calls Google's Search Console API with your own credentials. Its search analytics tool returns the same data as the Performance report without the screen's 1,000 row limit, up to 25,000 rows per call, grouped by query, page, country, device or date, with web, image, video, news and Discover search types.

Typical questions are which searches rank between positions 8 and 20, which pages lost clicks month over month, and whether a new URL is indexed. URL inspection reports Google's indexed version, not a live test, and it cannot request indexing. Two Indexing API tools notify Google about updated or removed URLs; Google documents that API for job posting and livestream pages.

Search Console data runs two to three days behind. The extension registers itself with Claude Code, Cursor, Codex, Gemini, Windsurf, Continue.dev, Cline and Copilot, and sign-in is OAuth, a service account key or gcloud Application Default Credentials. Outside VS Code it needs Node.js 22 or newer.

## Features

- **Search analytics:** Clicks, impressions, CTR and position, grouped and filtered, up to 25,000 rows per call.
- **URL inspection:** Index status, crawl details, mobile usability and rich results for one URL.
- **Sitemap management:** List and submit sitemaps for a property.
- **Property listing:** List and add properties by URL prefix or domain.
- **Indexing API:** Notify Google of updated or removed URLs and read the last notification.
- **Runs locally:** Calls Google with your credentials and has no telemetry.

## Good for

- Find searches ranking between positions 8 and 20
- Find pages that lost clicks since last month
- Check a page is indexed after publishing
- Submit a new sitemap
- Spot two pages competing for the same query

## Install

### Claude Code (Terminal)

```sh
claude mcp add google-search-console-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-search-console-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-search-console-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-search-console-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "google-search-console-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-search-console-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-search-console-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-search-console-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}
```

## Tools

- `gsc_list_sites`: List Search Console properties your account can open.
- `gsc_search_analytics`: Query clicks, impressions, CTR and position.
- `gsc_inspect_url`: Inspect a URL's index status and crawl details.
- `gsc_list_sitemaps`: List sitemaps for a property.
- `gsc_submit_sitemap`: Submit a sitemap.
- `gsc_add_site`: Add a property.
- `indexing_notify`: Tell Google a URL was updated or removed.
- `indexing_status`: Show the last notification for a URL.

## FAQ

### Is it free?

Yes, it is MIT licensed and Google does not charge for the API.

### Which agents does it work with?

Claude Code, Cursor, Codex, Gemini, Windsurf, Continue.dev, Cline and VS Code Copilot.

### Why does a property say not found?

Use the exact property name: a trailing-slash URL prefix or sc-domain:example.com.

### Where does my data go?

Only to Google; the server runs on your machine.

### Is Google Search Console MCP free?

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

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

Run this command in your terminal: claude mcp add google-search-console-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-search-console-mcp

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

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