erica-gsc-mcp

MCP server for Google Search Console - access GSC data directly from Claude.

Installation

npx -y erica-gsc-mcp

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Alternative: Service Account

For server-to-server authentication, use a Google Service Account:

{
  "mcpServers": {
    "erica-gsc": {
      "command": "npx",
      "args": ["-y", "erica-gsc-mcp"],
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY": "{\"type\":\"service_account\",\"project_id\":\"...\",\"private_key\":\"...\"}"
      }
    }
  }
}

Tools Available

| Tool | Description | |------|-------------| | gsc_list_sites | List all sites/properties in GSC | | gsc_get_performance | Get search performance data (clicks, impressions, CTR, position) | | gsc_get_top_queries | Get top search queries sorted by clicks | | gsc_get_top_pages | Get top performing pages sorted by clicks | | gsc_get_queries_for_page | Get all queries driving traffic to a specific page | | gsc_get_pages_for_query | Get all pages ranking for a specific query | | gsc_compare_periods | Compare performance between two time periods |

Getting Your Tokens

To get your GSC OAuth tokens:

1. Go to Google Cloud Console
2. Create OAuth 2.0 credentials (Desktop app)
3. Use the OAuth playground or ERICA's auth flow to get tokens
4. Copy the access_token and refresh_token to your config

Usage Examples

Once configured, ask Claude:

• "List my GSC sites"
• "Show me top queries for example.com in the last 28 days"
• "What pages are ranking for 'keyword' on my site?"
• "Compare this month's performance to last month"
• "What queries are driving traffic to https://example.com/page?"