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 Desktop, Cursor, **Codex CLI
How to install mcp-gsc?
aminforou/mcp-gsc
$git clone https://github.com/aminforou/mcp-gscInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install mcp-gsc by running `git clone https://github.com/aminforou/mcp-gsc`, then use it for the current task and follow its documentation at https://github.com/aminforou/mcp-gsc.
README.md
| 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;"> |
Related
6 picksType
- mcp-server-typescriptA Model Context Protocol (MCP) server for the DataForSEO API, enabling modular and extensible integration of DataForSEO endpoints with support for both HTTP and SSE transports.Jul 2026
- dataforseo-mcp-serverA comprehensive stdio MCP server for DataForSEO APIJun 2026
- meta-ads-mcpFacebook / Meta Ads automation with AI: analyze performance, test creatives, optimize spend.Jul 2026
- mcp-server-gscEnhanced Model Context Protocol server for Google Search Console with 25K row limit, regex filters, and automatic quick wins detectionFeb 2026
- postmark-mcpOfficial Postmark MCP server for sending emails via Claude and AI assistantsJul 2026
- seoThe SEO command for AI agents. Audit sites and research search opportunities with local, evidence-backed reports.Jul 2026
