Google Search Console MCP Server

GSC-MCP-Server

Google Search Console MCP Server — Connect Google Search Console to Claude, Cursor, and other MCP clients.

Features

• 🔍 Search Analytics — Query clicks, impressions, CTR, and position data
• 📊 SEO Opportunities — Find low-CTR keywords, detect cannibalization issues
• 📈 Reports — Weekly summaries, period comparisons
• 🗺️ Sitemaps — List, submit, and manage sitemaps
• 🔎 URL Inspection — Check indexing status (requires full scope)
• 💾 Caching — SQLite cache for faster repeated queries
• 🔐 Secure — OAuth tokens stored in OS keychain

Quick Start

# Install globally
npm install -g @appsyogi/gsc-mcp-server

# Set up OAuth credentials
gsc-mcp init

# Verify setup
gsc-mcp doctor

# Start the server (for MCP clients)
gsc-mcp run

Prerequisites

1. Create Google Cloud OAuth Credentials

You need to create your own OAuth credentials in Google Cloud Console:

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Search Console API:
   • Go to "APIs & Services" → "Library"
   • Search for "Google Search Console API"
   • Click "Enable"
4. Create OAuth credentials:
   • Go to "APIs & Services" → "Credentials"
   • Click "Create Credentials" → "OAuth client ID"
   • Choose "Desktop application"
   • Name it (e.g., "GSC-MCP")
   • Click "Create"
5. Copy the Client ID and Client Secret
6. Add test users (required while app is in testing mode):
   • Go to "APIs & Services" → "OAuth consent screen"
   • Scroll to "Test users" section
   • Click "Add users"
   • Add the Google account email(s) you'll use to authenticate
   • Click "Save"

Note: While your app's publishing status is "Testing", only test users can authenticate. You can add up to 100 test users.

2. Configure GSC-MCP

Run the init command and enter your credentials:

gsc-mcp init

This will:

• Prompt for your Client ID and Client Secret
• Open a browser for Google authentication
• Store your refresh token securely in the OS keychain

Usage

CLI Commands

# Initialize with OAuth (interactive)
gsc-mcp init

# Initialize with service account
gsc-mcp init --service-account /path/to/key.json

# Initialize with full scope (for sitemap submission, URL inspection)
gsc-mcp init --scope full

# Check configuration and connectivity
gsc-mcp doctor
gsc-mcp doctor --verbose

# Start MCP server (stdio mode)
gsc-mcp run

# Start in HTTP mode (for debugging)
gsc-mcp run --http 3333

# View current configuration
gsc-mcp config

# Clear credentials
gsc-mcp logout

MCP Client Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "gsc": {
      "command": "gsc-mcp",
      "args": ["run"]
    }
  }
}

VS Code (Copilot)

Add to your VS Code MCP settings (~/.vscode/mcp.json or workspace settings):

{
  "servers": {
    "gsc": {
      "command": "gsc-mcp",
      "args": ["run"],
      "type": "stdio"
    }
  }
}

Cursor

Add to your Cursor MCP config:

{
  "mcpServers": {
    "gsc": {
      "command": "npx",
      "args": ["-y", "@appsyogi/gsc-mcp-server", "run"]
    }
  }
}

Available Tools

Search Analytics

Sitemaps

URL Inspection

SEO Opportunities

Export