# gsc

gsc — an MCP server for Google Search Console API and Indexing API: search analytics, index status checks, sitemap submission, and structured data notifications.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: mikusnuz
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mikusnuz/gsc-mcp
- Updated: 2026-10-19
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gsc

## What it does

The server exposes all Search Console and Indexing API endpoints through 13 tools. You can query search performance data (clicks, impressions, CTR, position) grouped by device or date, inspect URL index status, submit sitemaps, and add properties.

Indexing API accepts notifications only for pages with `JobPosting` structured data or livestream pages with `BroadcastEvent` embedded in a `VideoObject`. Google confirms receipt but does not guarantee indexing. Authentication requires an OAuth2 refresh token or a service account JSON key. The API has a daily limit of 200 publish requests per project; a batch of 100 URLs counts as 100 requests.

For Indexing API tools, the service account must be added as a delegated owner in Search Console. User-level permission is insufficient.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GSC_CLIENT_ID`, `GSC_CLIENT_SECRET`, `GSC_REFRESH_TOKEN`, `GSC_SERVICE_ACCOUNT_KEY_PATH` — 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_KEY_PATH=<GSC_SERVICE_ACCOUNT_KEY_PATH> --transport stdio gsc -- npx -y @mikusnuz/gsc-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add gsc --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_KEY_PATH=<GSC_SERVICE_ACCOUNT_KEY_PATH> -- npx -y @mikusnuz/gsc-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gsc": {
            "command": "npx",
            "args": [
                "-y",
                "@mikusnuz/gsc-mcp"
            ],
            "env": {
                "GSC_CLIENT_ID": "<GSC_CLIENT_ID>",
                "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
                "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
                "GSC_SERVICE_ACCOUNT_KEY_PATH": "<GSC_SERVICE_ACCOUNT_KEY_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gsc": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mikusnuz/gsc-mcp"
            ],
            "env": {
                "GSC_CLIENT_ID": "<GSC_CLIENT_ID>",
                "GSC_CLIENT_SECRET": "<GSC_CLIENT_SECRET>",
                "GSC_REFRESH_TOKEN": "<GSC_REFRESH_TOKEN>",
                "GSC_SERVICE_ACCOUNT_KEY_PATH": "<GSC_SERVICE_ACCOUNT_KEY_PATH>"
            }
        }
    }
}
```
Replace <…> with your own values

### 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_KEY_PATH=<GSC_SERVICE_ACCOUNT_KEY_PATH> gsc npx -y @mikusnuz/gsc-mcp
```
Replace <…> with your own values

## When to use it
- query search performance for the last 30 days
- notify Google about an updated job posting or livestream
- diagnose why a page is not indexed
- compare click-through rates between mobile and desktop
- submit a sitemap to Search Console

## Example prompts
- Show me the top 10 queries from the last 30 days
- Check the index status of `/careers/developer`
- Send a notification for the job posting at `/job/12345`

## Similar
- [google-search-console](https://affpapa.org/en/nevibecode/skills/acedatacloud-google-search-console.md) — skill · 188 installs
- [Google Search Console](https://affpapa.org/en/nevibecode/mcp/get-mcp-ads-google-search-console.md) — MCP server
- [gsc-portfolio-audit](https://affpapa.org/en/nevibecode/skills/gsc-portfolio-audit.md) — skill · 112 installs
- [web-analytics-agent-skill](https://affpapa.org/en/nevibecode/skills/web-analytics-agent-skill.md) — skill · 306 installs
- [schema](https://affpapa.org/en/nevibecode/skills/schema.md) — skill · 91700 installs
- [Grounded AEO](https://affpapa.org/en/nevibecode/mcp/grounded-aeo.md) — MCP server · 571 installs

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