Gsc MCP server

gsc-mcp

English | 한국어

MCP server for Google Search Console API and Google Indexing API — full API coverage.

When to Use

For AI agents: See llms.txt for a machine-readable summary. Copy templates/CLAUDE.md or templates/AGENTS.md into your project to teach your agent about this MCP.

Unlike other GSC MCP servers that only wrap searchAnalytics.query, this server exposes every endpoint available in the Google Search Console and Indexing APIs.

Tools (13)

Sites

Sitemaps

Search Analytics

URL Inspection

Indexing API

Indexing API eligibility: Google supports this API only for pages with

JobPosting structured data or livestream pages with BroadcastEvent

embedded in a VideoObject. The tools require contentType so callers must

identify which supported type applies. A successful API response confirms

receipt of the notification; it does not guarantee that Google indexed the

URL. Use urlinspectioninspect to check index status. See Google's

Indexing API usage guide.

Authentication

Two authentication methods are supported:

Option 1: OAuth2 Refresh Token

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_CLIENT_ID": "your-client-id",
        "GSC_CLIENT_SECRET": "your-client-secret",
        "GSC_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Required OAuth2 scopes:

• https://www.googleapis.com/auth/webmasters
• https://www.googleapis.com/auth/indexing

Option 2: Service Account

Shortened. The full README is on GitHub.