# google-gsc-mcp

The google-gsc-mcp MCP server for Claude Code connects an agent to Google Search Console. Ask about search traffic, sitemaps, or whether URLs are indexed.

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

## What it does

google-gsc-mcp exposes Google Search Console data to an MCP client. Its listed tools cover site discovery, clicks, impressions, CTR and average position, date comparisons, and the queries that bring visitors to a page. The server description also lists sitemap data and URL inspection.

Node.js 20 or newer and access to Google Search Console are required. OAuth setup uses a Google Cloud project, the Search Console API, a Client ID, and a Client secret; service-account login instead requires a JSON key file and site access for that account. Without valid Google credentials, the server cannot authenticate.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `WSP_CLIENT_ID`, `WSP_CLIENT_SECRET`, `WSP_OAUTH_FILE`, `WSP_SERVICE_ACCOUNT_FILE`, `WSP_ALLOW_WRITES` — 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 WSP_CLIENT_ID=<WSP_CLIENT_ID> --env WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> --env WSP_OAUTH_FILE=<WSP_OAUTH_FILE> --env WSP_SERVICE_ACCOUNT_FILE=<WSP_SERVICE_ACCOUNT_FILE> --env WSP_ALLOW_WRITES=<WSP_ALLOW_WRITES> --transport stdio google-gsc-mcp -- npx -y google-gsc-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add google-gsc-mcp --env WSP_CLIENT_ID=<WSP_CLIENT_ID> --env WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> --env WSP_OAUTH_FILE=<WSP_OAUTH_FILE> --env WSP_SERVICE_ACCOUNT_FILE=<WSP_SERVICE_ACCOUNT_FILE> --env WSP_ALLOW_WRITES=<WSP_ALLOW_WRITES> -- npx -y google-gsc-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "google-gsc-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "google-gsc-mcp"
            ],
            "env": {
                "WSP_CLIENT_ID": "<WSP_CLIENT_ID>",
                "WSP_CLIENT_SECRET": "<WSP_CLIENT_SECRET>",
                "WSP_OAUTH_FILE": "<WSP_OAUTH_FILE>",
                "WSP_SERVICE_ACCOUNT_FILE": "<WSP_SERVICE_ACCOUNT_FILE>",
                "WSP_ALLOW_WRITES": "<WSP_ALLOW_WRITES>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "google-gsc-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "google-gsc-mcp"
            ],
            "env": {
                "WSP_CLIENT_ID": "<WSP_CLIENT_ID>",
                "WSP_CLIENT_SECRET": "<WSP_CLIENT_SECRET>",
                "WSP_OAUTH_FILE": "<WSP_OAUTH_FILE>",
                "WSP_SERVICE_ACCOUNT_FILE": "<WSP_SERVICE_ACCOUNT_FILE>",
                "WSP_ALLOW_WRITES": "<WSP_ALLOW_WRITES>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WSP_CLIENT_ID=<WSP_CLIENT_ID> -e WSP_CLIENT_SECRET=<WSP_CLIENT_SECRET> -e WSP_OAUTH_FILE=<WSP_OAUTH_FILE> -e WSP_SERVICE_ACCOUNT_FILE=<WSP_SERVICE_ACCOUNT_FILE> -e WSP_ALLOW_WRITES=<WSP_ALLOW_WRITES> google-gsc-mcp npx -y google-gsc-mcp
```
Replace <…> with your own values

## When to use it
- inspect clicks, impressions, CTR, and search position
- compare Search Console metrics across date ranges
- find queries that lead visitors to a page
- check site access and inspect URL indexing

## Example prompts
- Compare search metrics for my site across two date ranges and report the largest changes.
- Which search queries bring visitors to `/pricing`?
- Check whether the URLs on my site are indexed.

## Similar
- [gsc-portfolio-audit](https://affpapa.org/en/nevibecode/skills/gsc-portfolio-audit.md) — skill · 112 installs
- [gsc](https://affpapa.org/en/nevibecode/mcp/gsc.md) — MCP server · ★ 8 repo stars
- [GSC Scanner](https://affpapa.org/en/nevibecode/mcp/gsc-scanner.md) — MCP server · ★ 18 repo stars
- [Keyword Research — Google Suggest, Intent & Long-Tail](https://affpapa.org/en/nevibecode/mcp/keyword-research-google-suggest-intent-long-tail.md) — MCP server · 6583 installs
- [Google Trends](https://affpapa.org/en/nevibecode/mcp/google-trends.md) — MCP server · 411 installs
- [google-search](https://affpapa.org/en/nevibecode/skills/google-search.md) — skill · 4800 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
