Google Search Console

MCP server · by acamolese

Search Python v3.0.1

Google Search Console: SEO audits, performance queries, URL inspection, indexing checks.

View source ↗ Website ↗ Generate config for multiple servers More servers

Install

Pin version registry version 3.0.1

Python
uvx mcp-google-search-console

Python
uvx mcp-google-search-console@3.0.1

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

claude_desktop_config.json

{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console@3.0.1"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

Format verified against the official Claude Desktop docs ↗.

terminal

claude mcp add --env GSC_CLIENT_SECRET=<YOUR_GSC_CLIENT_SECRET> --env GSC_REFRESH_TOKEN=<YOUR_GSC_REFRESH_TOKEN> google-search-console-mcp -- uvx mcp-google-search-console

claude mcp add --env GSC_CLIENT_SECRET=<YOUR_GSC_CLIENT_SECRET> --env GSC_REFRESH_TOKEN=<YOUR_GSC_REFRESH_TOKEN> google-search-console-mcp -- uvx mcp-google-search-console@3.0.1

Format verified against the official Claude Code docs ↗.

.cursor/mcp.json

{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console@3.0.1"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

Format verified against the official Cursor docs ↗.

.vscode/mcp.json

{
  "servers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

{
  "servers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console@3.0.1"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

Format verified against the official VS Code docs ↗.

mcp_config.json

{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

{
  "mcpServers": {
    "google-search-console-mcp": {
      "command": "uvx",
      "args": [
        "mcp-google-search-console@3.0.1"
      ],
      "env": {
        "GSC_CLIENT_SECRET": "<YOUR_GSC_CLIENT_SECRET>",
        "GSC_REFRESH_TOKEN": "<YOUR_GSC_REFRESH_TOKEN>"
      }
    }
  }
}

Format verified against the official Windsurf docs ↗.

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

GSC_CLIENT_ID — OAuth client ID from a Desktop app credential in Google Cloud Console.
GSC_CLIENT_SECRET secret — OAuth client secret paired with GSC_CLIENT_ID.
GSC_REFRESH_TOKEN secret — OAuth refresh token, from `mcp-google-search-console auth`.
GSC_SERVICE_ACCOUNT_FILE — Path to a service account JSON key, as an alternative to OAuth.
GSC_REPORT_LANGUAGE — Language of the generated HTML audit report: en or it. Defaults to en.
GSC_DATA_STATE — Default freshness of the data: all (includes today's partial data) or final.

GitHub

⭐ 8 stars · 最近更新于 16 天前 · MIT license

About this server

Distributed as Python, listed under Search. Review our MCP security guide before granting access to real data.

Frequently asked questions

How do I install Google Search Console?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is Google Search Console free to use?

The MCP server itself is free to install. The source is public on https://github.com/acamolese/google-search-console-mcp. Any third-party service it calls may require its own API key and account.

Which clients support Google Search Console?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.

Add this badge

Publish this server? Link back with a badge on your README or site — copy either snippet.

Markdown

[![Listed on MCPNav](https://mcpnav.net/badge/google-search-console-mcp.svg)](https://mcpnav.net/server/google-search-console-mcp/)

HTML

<a href="https://mcpnav.net/server/google-search-console-mcp/"><img src="https://mcpnav.net/badge/google-search-console-mcp.svg" alt="Listed on MCPNav" height="20"></a>