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

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

{
  "mcpServers": {
    "gsc-mcp": {
      "command": "npx",
      "args": ["-y", "@mikusnuz/gsc-mcp"],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account-key.json"
      }
    }
  }
}

The service account must be added as an owner or user in Google Search Console for each site.

Setup Guide

OAuth2 Setup

1. Go to Google Cloud Console
2. Create a project (or select existing)
3. Enable Search Console API and Indexing API
4. Create OAuth 2.0 credentials (Desktop app type)
5. Use the OAuth Playground to generate a refresh token with scopes:
   • https://www.googleapis.com/auth/webmasters
   • https://www.googleapis.com/auth/indexing

Service Account Setup

1. Go to Google Cloud Console
2. Create a service account
3. Download the JSON key file
4. Enable Search Console API and Indexing API
5. In Search Console, add the service account email as an owner for your sites

License

MIT