lionkiii/google-searchconsole-mcp

A Model Context Protocol (MCP) server that connects **Google Search Console** to AI assistants like **Claude Desktop**, **Cursor**, **Windsurf**, and any MCP-compatible client. Analyze your SEO data, inspect URLs, find keyword opportunities, and track search performance — all through natural language.
> **No Google Cloud setup required.** Install, authenticate with your Google account, and start querying your Search Console data in under 2 minutes.
What Can You Do?
Ask Claude questions like:
- *"What are my top performing pages this month?"*
- *"Find keywords where I have high impressions but low CTR"*
- *"Compare my search performance this month vs last month"*
- *"Is this URL indexed? Any issues?"*
- *"Show me my brand vs non-brand traffic split"*
Quick Start
1. Install
2. Authenticate (one time)
Opens your browser — log in with your Google account and grant Search Console read access. Your tokens are saved locally to ~/.gsc-mcp/tokens/. **Your data stays on your machine.**
**Multiple accounts:**
3. Add to Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Restart Claude Desktop. Done — your Search Console data is now available in Claude.
Use with Other MCP Clients
Works with any MCP-compatible client including **Cursor**, **Windsurf**, **VS Code + Cline**, and more. Just point the MCP client to:
Available Tools (13 SEO Tools)
| Tool | Description |
|------|-------------|
| list_accounts | List all authenticated Google accounts and their Search Console sites |
| list_sites | List all Search Console properties you have access to |
| query_search_analytics | Query clicks, impressions, CTR, and position by any dimension (query, page, country, device, date) |
| inspect_url | Check URL indexing status, mobile usability, and rich results eligibility |
| list_sitemaps | List all submitted sitemaps and their status |
| find_keyword_opportunities | Discover high-impression, low-CTR keywords — quick SEO wins |
| get_top_pages | Get top pages sorted by clicks, impressions, CTR, or position |
| compare_performance | Compare search performance between two time periods (week-over-week, month-over-month) |
| analyze_brand_queries | Analyze brand vs non-brand organic traffic split |
| get_keyword_trend | Get daily trend data for a specific keyword |
| export_analytics | Export search analytics data as CSV or JSON |
| query_by_search_appearance | Filter results by search appearance: AMP, FAQ, HowTo, Rich Results, Video, etc. |
| query_by_search_type | Filter by search type: web, image, video, news, or discover |
Examples
Example 1: Find your top performing pages
**User prompt:** "Show me my top 10 pages by clicks for the last 30 days"
**Expected behavior:**
- Calls get_top_pages with your site URL, date range of last 30 days, sortBy: "clicks", and limit: 10
- Returns a ranked list of your top 10 pages with clicks, impressions, CTR, and average position for each
- Helps identify your strongest content and highest-traffic landing pages
Example 2: Discover keyword optimization opportunities
**User prompt:** "Find keywords where I have high impressions but low CTR on example.com"
**Expected behavior:**
- Calls find_keyword_opportunities with your site URL and a 28-day date range
- Filters for queries with 100+ impressions and less than 3% CTR within the top 20 positions