Google Search Console MCP Server

An MCP (Model Context Protocol) server that provides tools to query Google Search Console data from AI assistants like Claude.

Features

• Search Analytics -- Query clicks, impressions, CTR, and position with filtering by query, page, country, device, and date

• URL Inspection -- Check indexation status, crawl info, canonical URLs, mobile usability, and rich results

• Sitemap Management -- List, get details, submit, and delete sitemaps

• Site Listing -- List all verified properties and their permission levels

Related MCP server: mcp-gsc

Tools

Installation

Prerequisites

• Python 3.11+

• uv (recommended) or pip

• Google Cloud credentials with Search Console API access

Install dependencies

git clone https://github.com/kn00m1/google-search-console-mcp.git
cd google-search-console-mcp
uv sync

Authentication

The server tries credentials in this order:

1. Cached token (~/.config/gsc-mcp/token.json) -- from a previous OAuth flow

2. Application Default Credentials (ADC) -- from gcloud auth application-default login

3. OAuth2 browser flow -- using ~/.config/gsc-mcp/client_secrets.json

Quickest setup (ADC)

gcloud auth application-default login --scopes=https://www.googleapis.com/auth/webmasters.readonly

OAuth2 setup (if ADC doesn't cover your scopes)

1. Create an OAuth client ID (Desktop app) in Google Cloud Console

2. Download the JSON and save it as ~/.config/gsc-mcp/client_secrets.json

3. The server will open a browser for consent on first run

Usage

With Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "google-search-console": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/google-search-console-mcp", "python", "-m", "gsc_mcp.server"],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

With any MCP client

uv run python -m gsc_mcp.server

The server communicates over stdio using the MCP protocol.

Enable write access

Set the environment variable to unlock sitemap submit/delete tools:

GSC_WRITE_ACCESS=true uv run python -m gsc_mcp.server

Security

• Token files are stored with 0600 permissions

• API responses are sanitized against prompt injection patterns

• Error messages redact OAuth tokens and API keys

• Write tools (submit/delete sitemap) are disabled by default

License

MIT