mcp-gsc

Overview

This MCP server provides comprehensive access to Google Search Console data through AI assistants like Claude Desktop, Cursor, Codex CLI, Gemini CLI, and Antigravity. It enables SEO professionals to analyze website performance metrics, search queries, indexing status, and sitemap information directly through conversation. The server supports both OAuth and Service Account authentication methods and provides detailed tools for property management, search analytics, URL inspection, and sitemap management.

Try asking AI

After installing, here are 4 things you can ask your AI assistant:

• get_capabilities

  Lists all tools and shows auth status — call this first if unsure

  Try:Call get_capabilities to see available toolsTry:What tools do I have access to?
• list_properties

  Shows all your GSC properties

  Try:List all my GSC propertiesTry:What sites do I have access to in Search Console?
• get_site_details

  Details about a specific site

  Try:Get details for mywebsite.comTry:Show me verification details for my main site
• get_search_analytics

  Top queries and pages with clicks, impressions, CTR, position

  Try:Show me top search queries for mywebsite.comTry:What pages are getting the most traffic?
• get_performance_overview

  Summary of site performance

  Try:Create a performance overview for mywebsite.comTry:How has my site been performing recently?
• compare_search_periods

  Compare performance between two time periods

  Try:Compare my site's performance between January and FebruaryTry:How did my traffic change last month vs this month?
• inspect_url_enhanced

  Detailed crawl/index status for a URL

  Try:Inspect mywebsite.com/product-pageTry:Check why my landing page isn't ranking well
• batch_url_inspection

  Inspect up to 10 URLs at once

  Try:Check these URLs for issues: mywebsite.com/page1, mywebsite.com/page2Try:Inspect all my top pages
• get_sitemaps

  Lists all sitemaps for a site

  Try:Show me all sitemaps for mywebsite.comTry:What sitemaps are submitted to my site?
• list_sitemaps_enhanced

  Detailed sitemap info including errors and warnings

  Try:Show detailed sitemap info for mywebsite.comTry:Are there any errors in my sitemaps?
• manage_sitemaps

  Submit or delete sitemaps

  Try:Submit my new sitemap.xmlTry:Remove old-sitemap.xml from my site
• reauthenticate

  Re-run the OAuth browser login (switch accounts)

  Try:I need to switch to a different Google accountTry:Re-authenticate my access to Search Console

Comparable tools

Installation

# 1. Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
echo 'source $HOME/.local/bin/env' >> ~/.zshrc

{
  "mcpServers": {
    "gscServer": {
      "command": "/FULL/PATH/TO/uvx",
      "args": ["mcp-search-console"],
      "env": {
        "GSC_OAUTH_CLIENT_SECRETS_FILE": "/full/path/to/client_secrets.json"
      }
    }
  }
}

git clone https://github.com/AminForou/mcp-gsc.git
cd mcp-gsc
uv venv .venv
uv pip install -r requirements.txt

Compare mcp-gsc with