Google Search Console MCP Server

MCP server for querying Google Search Console data - rankings, clicks, impressions for websites.

Setup

1. Install dependencies:

   npm install

2. Configure credentials:

   Copy .env.example to .env and fill in your values:

   cp .env.example .env

   You'll need:

   • GSC_SITE_URL: Your site URL in GSC (e.g., sc-domain:bwengr.com)

   • GOOGLE_CLIENT_ID: OAuth2 client ID from Google Cloud Console

   • GOOGLE_CLIENT_SECRET: OAuth2 client secret

3. Get OAuth2 credentials:

   • Go to Google Cloud Console

   • Create a project or select existing

   • Enable "Search Console API"

   • Create OAuth2 credentials (Desktop app or Web application)

   • Add http://localhost:3000/oauth/callback as redirect URI

   • Copy Client ID and Secret to .env

Usage

npm start

Available MCP Tools

• getTopQueries - Get top search queries by clicks

• getPagePerformance - Get performance data for specific pages

• getSiteSummary - Get overall site search performance

• getRankingChanges - Find pages with significant ranking changes

Credentials

NEVER commit .env to GitHub. Credentials are stored locally only.