$git clone https://github.com/AminForou/mcp-gscA 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 Desktop, Cursor, **Codex CLI
| 1 | # Google Search Console MCP Server for SEOs |
| 2 | |
| 3 | A Model Context Protocol (MCP) server that connects [Google Search Console](https://search.google.com/search-console/about) (GSC) to AI assistants, allowing you to analyze your SEO data through natural language conversations. Works with **Claude Desktop**, **Cursor**, **Codex CLI**, **Gemini CLI**, **Antigravity**, and any other MCP-compatible client. |
| 4 | |
| 5 | > **Skip setup, get more.** A more advanced hosted version — one-click sign-in, added GA4 tools. Works with Claude Desktop, Claude Code, Claude.ai, Codex, Cursor, and any MCP client. Only **100 seats**. |
| 6 | > → [**Advanced GSC MCP (hosted)**](https://www.advancedgsc.com/mcp?utm_source=github&utm_medium=readme&utm_campaign=mcp-gsc&utm_content=hero-callout) |
| 7 | |
| 8 | --- |
| 9 | |
| 10 | ## What's New |
| 11 | |
| 12 | ### [0.3.2] — April 2026 |
| 13 | - **OAuth browser flow fixed for uvx** — removed the `isatty` block that prevented the browser login window from opening when running as an MCP subprocess on macOS. OAuth now works out of the box with `uvx`, no manual terminal run needed. |
| 14 | - **`get_capabilities` tool added** — call this to get a full list of available tools and current auth status in one shot. Useful when your AI assistant isn't sure what tools are available. |
| 15 | - **Better auth error messages** — all tools now tell you exactly what to do when credentials are missing or expired. |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | ## What Can This Do? |
| 20 | |
| 21 | **Property Management** |
| 22 | - See all your GSC properties in one place |
| 23 | - Get verification details and ownership information |
| 24 | - Add or remove properties from your account |
| 25 | |
| 26 | **Search Analytics & Reporting** |
| 27 | - Discover which queries bring visitors to your site |
| 28 | - Track impressions, clicks, and click-through rates |
| 29 | - Analyze performance trends and compare time periods |
| 30 | - Visualize data with charts created by your AI assistant |
| 31 | |
| 32 | **URL Inspection & Indexing** |
| 33 | - Check if specific pages have indexing problems |
| 34 | - See when Google last crawled your pages |
| 35 | - Inspect multiple URLs at once to identify patterns |
| 36 | |
| 37 | **Sitemap Management** |
| 38 | - View all sitemaps and their status |
| 39 | - Submit new sitemaps |
| 40 | - Check for errors or warnings |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## Available Tools |
| 45 | |
| 46 | | Tool | What It Does | What You Need to Provide | |
| 47 | |------|-------------|--------------------------| |
| 48 | | `get_capabilities` | Lists all tools and shows auth status — call this first if unsure | Nothing | |
| 49 | | `list_properties` | Shows all your GSC properties | Nothing | |
| 50 | | `get_site_details` | Details about a specific site | Site URL | |
| 51 | | `get_search_analytics` | Top queries and pages with clicks, impressions, CTR, position | Site URL, time period | |
| 52 | | `get_performance_overview` | Summary of site performance | Site URL, time period | |
| 53 | | `compare_search_periods` | Compare performance between two time periods | Site URL, two date ranges | |
| 54 | | `get_search_by_page_query` | Search terms driving traffic to a specific page | Site URL, page URL | |
| 55 | | `get_advanced_search_analytics` | Analytics with filters by country, device, query, page | Site URL | |
| 56 | | `inspect_url_enhanced` | Detailed crawl/index status for a URL | Site URL, page URL | |
| 57 | | `batch_url_inspection` | Inspect up to 10 URLs at once | Site URL, list of URLs | |
| 58 | | `check_indexing_issues` | Check multiple URLs for indexing problems | Site URL, list of URLs | |
| 59 | | `get_sitemaps` | Lists all sitemaps for a site | Site URL | |
| 60 | | `list_sitemaps_enhanced` | Detailed sitemap info including errors and warnings | Site URL | |
| 61 | | `manage_sitemaps` | Submit or delete sitemaps | Site URL, action | |
| 62 | | `reauthenticate` | Re-run the OAuth browser login (switch accounts) | Nothing | |
| 63 | |
| 64 | *Ask your AI assistant to "call get_capabilities" for the full list of all 20 tools.* |
| 65 | |
| 66 | --- |
| 67 | |
| 68 | <div align="center"> |
| 69 | <a href="https://www.advancedgsc.com/mcp?utm_source=github&utm_medium=readme&utm_campaign=mcp-gsc&utm_content=banner"> |
| 70 | <img src="assets/banner-1.jpg" alt="Skip setup — try the hosted MCP server with one-click Google sign-in. Works in ChatGPT and Claude web. Includes GA4 and advanced SEO tools." width="800" style="margin: 20px 0; border-radius: 8px;"> |