# Google Search Console

This MCP server reads Google Search Console data, checks indexing, and builds SEO audits. Use it for recurring reviews and traffic issue analysis.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: acamolese
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/acamolese/google-search-console-mcp
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/google-search-console

## What it does

The server connects an MCP client to Google Search Console and exposes tools for Search Analytics queries, URL inspection, indexing checks, and sitemap review. It can also surface query cannibalization, click losses, weak CTR, and pages that are steadily declining.

Built-in workflows cover a weekly report, an indexing audit, and content opportunity analysis. A full audit can be rendered as an HTML report with custom branding and English or Italian output. Access is read-only, so the server cannot change a property or its sitemaps.

Running it through `uvx` requires Google Search Console credentials. OAuth, a service account, or Application Default Credentials can provide access. The Google Search Console API must be enabled for the OAuth setup.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `GSC_CLIENT_ID`, `GSC_CLIENT_SECRET`, `GSC_REFRESH_TOKEN`, `GSC_SERVICE_ACCOUNT_FILE`, `GSC_REPORT_LANGUAGE`, `GSC_DATA_STATE` — 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 GSC_CLIENT_ID=<GSC_CLIENT_ID> --env GSC_CLIENT_SECRET=<GSC_CLIENT_SECRET> --env GSC_REFRESH_TOKEN=<GSC_REFRESH_TOKEN> --env GSC_SERVICE_ACCOUNT_FILE=<GSC_SERVICE_ACCOUNT_FILE> --env GSC_REPORT_LANGUAGE=<GSC_REPORT_LANGUAGE> --transport stdio google-search-console -- uvx mcp-google-search-console
```
Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-google-search-console <command>

### Codex

**Platform CLI**
```bash
codex mcp add google-search-console --env GSC_CLIENT_ID=<GSC_CLIENT_ID> --env GSC_CLIENT_SECRET=<GSC_CLIENT_SECRET> --env GSC_REFRESH_TOKEN=<GSC_REFRESH_TOKEN> --env GSC_SERVICE_ACCOUNT_FILE=<GSC_SERVICE_ACCOUNT_FILE> --env GSC_REPORT_LANGUAGE=<GSC_REPORT_LANGUAGE> -- uvx mcp-google-search-console
```
Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-google-search-console <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "google-search-console": {
            "command": "uvx",
            "args": [
                "mcp-google-search-console"
            ],
            "env": {
                "GSC_CLIENT_ID": "<GSC_CLIENT_ID>",
                "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
                "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
                "GSC_SERVICE_ACCOUNT_FILE": "<GSC_SERVICE_ACCOUNT_FILE>",
                "GSC_REPORT_LANGUAGE": "<GSC_REPORT_LANGUAGE>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-google-search-console <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "google-search-console": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-google-search-console"
            ],
            "env": {
                "GSC_CLIENT_ID": "<GSC_CLIENT_ID>",
                "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
                "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
                "GSC_SERVICE_ACCOUNT_FILE": "<GSC_SERVICE_ACCOUNT_FILE>",
                "GSC_REPORT_LANGUAGE": "<GSC_REPORT_LANGUAGE>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-google-search-console <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GSC_CLIENT_ID=<GSC_CLIENT_ID> -e GSC_CLIENT_SECRET=<GSC_CLIENT_SECRET> -e GSC_REFRESH_TOKEN=<GSC_REFRESH_TOKEN> -e GSC_SERVICE_ACCOUNT_FILE=<GSC_SERVICE_ACCOUNT_FILE> -e GSC_REPORT_LANGUAGE=<GSC_REPORT_LANGUAGE> google-search-console uvx mcp-google-search-console
```
Replace <…> with your own values. 1 more environment variable is in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-google-search-console <command>

## When to use it
- check which URLs are indexed
- spot queries shared by competing pages
- compare search performance across periods
- produce a branded HTML audit
- find sitemap errors and warnings

## Example prompts
- Use `gsc_traffic_drops` to inspect lost clicks and explain the likely causes.
- Run `gsc_indexing_issues` for these URLs and group the indexing problems.
- Create a weekly Google Search Console review with `gsc_weekly_report`.

## Similar
- [New-Term Radar](https://affpapa.org/en/nevibecode/mcp/new-term-radar.md) — MCP server · ★ 1823
- [NotFair](https://affpapa.org/en/nevibecode/mcp/notfair.md) — MCP server · ★ 4064
- [seo-monster](https://affpapa.org/en/nevibecode/mcp/seo-monster.md) — MCP server · ★ 555
- [Google Maps MCP Server](https://affpapa.org/en/nevibecode/mcp/google-maps-mcp-server.md) — MCP server · ★ 484
- [Search Console MCP](https://affpapa.org/en/nevibecode/mcp/search-console-mcp.md) — MCP server · ★ 310
- [squirrelscan](https://affpapa.org/en/nevibecode/mcp/squirrelscan.md) — MCP server · ★ 298

## Other versions with the same name
- [Google Search Console · akzar1el](https://affpapa.org/en/nevibecode/mcp/akzar1el-google-search-console.md) — ★ 6

---
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
