Google Search Console MCP Server

io.github.ni-c/google-search-console-mcp

Repository Registry

What is the Google Search Console MCP server?

MCP server for Google Search Console: properties, sitemaps, search analytics and URL inspection

How to install Google Search Console

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GSC_SERVICE_ACCOUNT_KEY
secret
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
secret
OAuth2 client secret. All three OAuth2 variables are required together.
GSC_REFRESH_TOKEN
secret
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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/google-search-console-mcp"
      ],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY": "<YOUR_GSC_SERVICE_ACCOUNT_KEY>",
        "GSC_SERVICE_ACCOUNT_KEY_FILE": "<YOUR_GSC_SERVICE_ACCOUNT_KEY_FILE>",
        "GSC_CLIENT_ID": "<YOUR_GSC_CLIENT_ID>",
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<YOUR_GOOGLE_APPLICATION_CREDENTIALS>",
        "GSC_SITE_URL": "<YOUR_GSC_SITE_URL>",
        "GSC_ALLOWED_SITES": "<YOUR_GSC_ALLOWED_SITES>",
        "GSC_READ_ONLY": "<YOUR_GSC_READ_ONLY>",
        "GSC_ALLOW_TOOLS": "<YOUR_GSC_ALLOW_TOOLS>",
        "GSC_DENY_TOOLS": "<YOUR_GSC_DENY_TOOLS>"
      }
    }
  }
}