by AminForou
Google Search Console Insights with Claude AI for SEOs
# Add to your Claude Code skills
git clone https://github.com/AminForou/mcp-gscApril 2026 (v0.3.0): Coming to the Cursor Marketplace — one-click install with bundled SEO skills. Also: token storage moved to user config dir (survives
uvxupgrades), all data tools now return structured JSON, and 39 new unit tests. See the Changelog for details.
A Model Context Protocol (MCP) server that connects Google Search Console (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with Claude, Cursor, Codex, Gemini CLI, Antigravity, and any other MCP-compatible client. This integration gives you access to property information, search analytics, URL inspection, and sitemap management—all through simple chat.
One-click install available — search for
mcp-search-consolein the Cursor Marketplace.
After installing, configure your credentials (see Getting Started below) then use the bundled skills directly in Cursor Agent chat:
| Skill | How to invoke | What it does |
|---|---|---|
| seo-weekly-report | "Run the SEO weekly report for example.com" | Full 28-day performance summary with period-over-period comparison and top queries |
| cannibalization-check | "Check for keyword cannibalization on example.com" | Finds queries where multiple pages compete; recommends which to keep |
| indexing-audit | "Audit indexing for my top pages" | Batch-inspects top 20 pages and returns a prioritized fix list |
| | | Surfaces position-11-20 queries with high impressions and low CTR |
No comments yet. Be the first to share your thoughts!
content-opportunities| Variable | Required | Description |
|---|---|---|
| GSC_OAUTH_CLIENT_SECRETS_FILE | One of these two | Path to your OAuth client_secrets.json |
| GSC_CREDENTIALS_PATH | One of these two | Path to your service account credentials JSON |
| GSC_DATA_STATE | Optional | all (default, matches GSC dashboard) or final (2–3 day lag) |
| GSC_ALLOW_DESTRUCTIVE | Optional | Set to true to enable add/delete site and delete sitemap tools |
After installing, ask your AI assistant: "Authenticate my Google Search Console" — it will run the reauthenticate tool which opens a browser window once to authorize access. Subsequent uses are token-based and require no interaction.
Property Management
Search Analytics & Reporting
URL Inspection & Indexing
Sitemap Management
Here's what you can ask your AI assistant to do once you've set up this integration:
| What You Can Ask For | What It Does | What You'll Need to Provide |
|---------------------------------|-------------------------------------------------------------|----------------------------------------------------------------|
| list_properties | Shows all your GSC properties | Nothing - just ask! |
| get_site_details | Shows details about a specific site | Your website URL |
| add_site | Adds a new site to your GSC properties | Your website URL |
| delete_site | Removes a site from your GSC properties | Your website URL |
| get_search_analytics | Shows top queries and pages with metrics | Your website URL, time period, and optional row_limit (default 20, max 500) |
| get_performance_overview | Gives a summary of site performance | Your website URL and time period |
| check_indexing_issues | Checks if pages have indexing problems | Your website URL and list of pages to check |
| inspect_url_enhanced | Detailed inspection of a specific URL | Your website URL and the page to inspect |
| get_sitemaps | Lists all sitemaps for your site | Your website URL |
| submit_sitemap | Submits a new sitemap to Google | Your website URL and sitemap URL |
For a complete list of all 20 available tools and their detailed descriptions, ask your AI assistant to "list tools" after setup.
Before using this tool, you'll need to create API credentials that allow your AI assistant to access your GSC data:
The tool supports two authentication methods:
This method allows you to authenticate with your own Google account, which is often more convenient than using a service account. It will have access to the same resources you normally do.
Set GSC_SKIP_OAUTH to "true", "1", or "yes" to skip OAuth authentication and use only service account authentication
https://www.googleapis.com/auth/webmasters to your projectclient_secrets.json)GSC_OAUTH_CLIENT_SECRETS_FILE environment variable to point to its locationWhen you run the tool for the first time with OAuth authentication, it will open a browser window asking you to sign in to your Google account and authorize the application. After authorization, the tool will save the token for future use.
This method uses a service account, which is useful for automated scripts or when you don't want to use your personal Google account. This requires adding the service account as a user in Google Search Console.
service_account_credentials.json in the same directory as the script or set the GSC_CREDENTIALS_PATH environment variable to point to its location🎬 Watch this beginner-friendly tutorial on Youtube:
Click the image above to watch the step-by-step video tutorial
You'll need to install these tools on your computer:
Make sure Python is properly installed and available in your system path before proceeding.
Option A — uvx (simplest, no clone needed)
If you have [uv](https://docs.astral.sh/uv/