# search-console-mcp

Connects Google Search Console to an MCP client for read-only search data and SEO analysis in chat. Use it to inspect traffic, indexing, and search queries.

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

## What it does

search-console-mcp runs locally with Node and connects Google Search Console to Claude Code, Codex, Cursor, and other MCP clients. After Google sign-in, the server can read properties, queries, clicks, impressions, CTR, positions, URL indexing status, and sitemaps.

It includes period comparisons and ten prepared SEO analyses covering traffic drops, cannibalization, internal links, indexing, and query opportunities. The server is read-only by design: the `webmasters.readonly` scope cannot change properties, submit sitemaps, or perform write operations.

You need `npx` and access to Google Search Console. A Google Cloud project and API keys are not required; tokens stay on the local machine under `~/.search-console-mcp/`. Google sign-in is required before the server can read Search Console data.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add search-console-mcp -- npx -y search-console-mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add sudomichael-search-console-mcp -- npx -y search-console-mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sudomichael-search-console-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "search-console-mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sudomichael-search-console-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "search-console-mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add sudomichael-search-console-mcp npx -y search-console-mcp-server
```

## When to use it
- spot pages that lost clicks
- compare queries, impressions, and rankings
- check whether a URL is indexed
- find competing pages for one query
- plan internal links from existing data

## Example prompts
- Show me the pages that lost the most clicks this month compared with the previous month.
- Find queries ranked from positions 8 to 15 with real impressions and rank the closest page-one opportunities.
- Check whether `https://mysite.com/pricing` is indexed and explain the reason if it is not.

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

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