# Google Search Console MCP

Google Search Console MCP is an MCP server for Claude Code that connects an AI agent to Search Console data for reviewing organic search metrics, inspecting URLs, and managing XML sitemaps.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 43 repo stars
- Author: surendranb
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/surendranb/google-search-console-mcp
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from gsc.builditwithai.xyz and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/surendranb-google-search-console-mcp

## What it does

The server returns clicks, impressions, CTR, and average position, grouped by search query, page, country, device, or date. It can also list verified Search Console properties and inspect a URL for indexing state, crawl problems, canonicalization, and mobile usability.

You can retrieve submitted XML sitemaps, send a new one, or remove an outdated entry. Other tools load SEO diagnostic playbooks and show which analytical skills are available. Set `GOOGLE_APPLICATION_CREDENTIALS` for access. The package gathers anonymous diagnostic telemetry; set `DO_NOT_TRACK=1` or `MCP_TELEMETRY_OPT_OUT=1` to opt out.

Claude Code runs the server through `uvx`. It needs Google credentials to access Search Console.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `GOOGLE_APPLICATION_CREDENTIALS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --transport stdio surendranb-google-search-console-mcp -- uvx google-search-console-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from google-search-console-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add surendranb-google-search-console-mcp --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> -- uvx google-search-console-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from google-search-console-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "surendranb-google-search-console-mcp": {
            "command": "uvx",
            "args": [
                "google-search-console-mcp"
            ],
            "env": {
                "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from google-search-console-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "surendranb-google-search-console-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "google-search-console-mcp"
            ],
            "env": {
                "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from google-search-console-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> surendranb-google-search-console-mcp uvx google-search-console-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from google-search-console-mcp <command>

## When to use it
- compare clicks and impressions across search queries
- inspect a URL for indexing and crawl issues
- review submitted XML sitemaps
- submit a new sitemap to Search Console
- remove an outdated sitemap entry

## Example prompts
- Compare clicks, impressions, and average position by query for this site over the selected dates.
- Check whether this URL is indexed and report crawl or canonicalization issues.
- List the site's sitemaps and remove the obsolete one.

## Similar
- [google-search-console](https://affpapa.org/en/nevibecode/skills/google-search-console.md) — skill · 2100 installs
- [pp-google-search-console](https://affpapa.org/en/nevibecode/skills/pp-google-search-console.md) — skill · 527 installs
- [Google Search Console](https://affpapa.org/en/nevibecode/mcp/google-search-console.md) — MCP server · ★ 11 repo stars
- [QuerySail: Google Search Console](https://affpapa.org/en/nevibecode/mcp/querysail-google-search-console.md) — MCP server
- [Search Console MCP](https://affpapa.org/en/nevibecode/mcp/search-console-mcp.md) — MCP server · ★ 330 repo stars
- [search-console-mcp](https://affpapa.org/en/nevibecode/mcp/sudomichael-search-console-mcp.md) — MCP server · ★ 8 repo stars

## Other versions with the same name
- [Google Search Console MCP · scalably-io](https://affpapa.org/en/nevibecode/mcp/google-search-console-mcp.md) — ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
