Google Search Console MCP Server

by ni-cio.github.ni-c/google-search-console-mcpv0.3.0

Google Search Console: create and verify properties, manage sitemaps, inspect URLs and pull the Performance report, with confirmation for irreversible calls.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Google Search Console MCP server

claude mcp add google-search-console-ni-c -e GSC_SERVICE_ACCOUNT_KEY='<gsc-service-account-key>' -e GSC_CLIENT_SECRET='<gsc-client-secret>' -e GSC_REFRESH_TOKEN='<gsc-refresh-token>' -- npx -y @ni-c/google-search-console-mcp

{
  "mcpServers": {
    "google-search-console-ni-c": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/google-search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY": "<gsc-service-account-key>",
        "GSC_CLIENT_SECRET": "<gsc-client-secret>",
        "GSC_REFRESH_TOKEN": "<gsc-refresh-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "google-search-console-ni-c": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/google-search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY": "<gsc-service-account-key>",
        "GSC_CLIENT_SECRET": "<gsc-client-secret>",
        "GSC_REFRESH_TOKEN": "<gsc-refresh-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "google-search-console-ni-c": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/google-search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY": "<gsc-service-account-key>",
        "GSC_CLIENT_SECRET": "<gsc-client-secret>",
        "GSC_REFRESH_TOKEN": "<gsc-refresh-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "google-search-console-ni-c": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/google-search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY": "<gsc-service-account-key>",
        "GSC_CLIENT_SECRET": "<gsc-client-secret>",
        "GSC_REFRESH_TOKEN": "<gsc-refresh-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GSC_SERVICE_ACCOUNT_KEY	—	yes	Service account key as JSON, or base64-encoded JSON. One of the three credential options.
GSC_SERVICE_ACCOUNT_KEY_FILE	—	—	Path to a service account key file. Alternative to GSC_SERVICE_ACCOUNT_KEY.
GSC_CLIENT_ID	—	—	OAuth2 client id. Use together with GSC_CLIENT_SECRET and GSC_REFRESH_TOKEN.
GSC_CLIENT_SECRET	—	yes	OAuth2 client secret. All three OAuth2 variables are required together.
GSC_REFRESH_TOKEN	—	yes	OAuth2 refresh token. All three OAuth2 variables are required together.
GOOGLE_APPLICATION_CREDENTIALS	—	—	Path to application default credentials, used when no GSC_ credential is set.
GSC_SITE_URL	—	—	Default property, e.g. sc-domain:example.com or https://example.com/ — makes site_url optional
GSC_ALLOWED_SITES	—	—	Comma-separated properties this server may touch; anything else is refused
GSC_READ_ONLY	—	—	Set to true to register only the read tools (default: false)
GSC_ALLOW_TOOLS	—	—	Comma-separated tool names or list_* prefixes to register; 'essential' selects a curated preset (default: all tools)
GSC_DENY_TOOLS	—	—	Comma-separated tool names or list_* prefixes to remove from whatever the allow list left

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-06 · 4d ago · GitHub
Latest release
2026-09-07 · 32d ago · GitHub · v0.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-07 · 32d ago · official registry · v0.3.0

FAQ

›How do I install the Google Search Console MCP server in Claude Code?

Run: claude mcp add google-search-console-ni-c -e GSC_SERVICE_ACCOUNT_KEY='<gsc-service-account-key>' -e GSC_CLIENT_SECRET='<gsc-client-secret>' -e GSC_REFRESH_TOKEN='<gsc-refresh-token>' -- npx -y @ni-c/google-search-console-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Google Search Console require an API key?

Yes. It expects GSC_SERVICE_ACCOUNT_KEY, GSC_CLIENT_SECRET, GSC_REFRESH_TOKEN, of which 3 are secrets.

›Can I use Google Search Console as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Google Search Console in the official MCP registry?

Yes, as io.github.ni-c/google-search-console-mcp.