pijusz avatar

Mcp Gsc

pijusz/mcp-gsc

Wraps the Google Search Console API so you can query search analytics, inspect URL indexing status, and manage sitemaps through Claude. Out of the box you get 7 core tools covering performance queries with dimensions like query, page, country, and device, plus URL inspection and sitemap management. Flip an environment variable to unlock 13 extended tools for things like cannibalization detection, quick wins analysis, and content decay tracking. Write operations for adding sites and submitting sitemaps are gated behind a separate flag. Handles OAuth setup with a CLI wizard, supports service accounts for server environments, and auto-resolves bare domains to your verified GSC properties. Built for SEO work where you want to pull performance data or diagnose indexing issues without leaving your editor.

GitHub stars
1
tools
27
transport
STDIO
last updated
Mar 23, 2026

Tools

27 tools

Public tool metadata for what this MCP can expose to an agent.

list_propertiesList all GSC properties with permission levels

List all GSC properties with permission levels

No parameter schema in public metadata yet.

get_property_detailsVerification info, ownership, permissions for a property

Verification info, ownership, permissions for a property

No parameter schema in public metadata yet.

search_analyticsQuery search performance (clicks, impressions, CTR, position) with dimensions, filters, and brand segmentation

Query search performance (clicks, impressions, CTR, position) with dimensions, filters, and brand segmentation

No parameter schema in public metadata yet.

list_sitemapsList sitemaps with status, type, indexed counts, errors

List sitemaps with status, type, indexed counts, errors

No parameter schema in public metadata yet.

get_sitemapDetailed sitemap info with content breakdown

Detailed sitemap info with content breakdown

No parameter schema in public metadata yet.

inspect_urlURL indexing status, crawl info, rich results, canonicals

URL indexing status, crawl info, rich results, canonicals

No parameter schema in public metadata yet.

batch_inspect_urlsInspect up to 10 URLs at once with categorized results

Inspect up to 10 URLs at once with categorized results

No parameter schema in public metadata yet.

export_csvExport full search analytics to a local CSV file (auto-paginates 25K rows per call, up to 1M rows)

Export full search analytics to a local CSV file (auto-paginates 25K rows per call, up to 1M rows)

No parameter schema in public metadata yet.

performance_overviewAggregate metrics + daily trend breakdown

Aggregate metrics + daily trend breakdown

No parameter schema in public metadata yet.

compare_periodsCompare two date ranges with delta calculations

Compare two date ranges with delta calculations

No parameter schema in public metadata yet.

top_moversBiggest gains and drops between periods

Biggest gains and drops between periods

No parameter schema in public metadata yet.

device_country_breakdownPerformance by device and/or country

Performance by device and/or country

No parameter schema in public metadata yet.

quick_winsHigh-impression, low-CTR queries in striking distance (position 4-20)

High-impression, low-CTR queries in striking distance (position 4-20)

No parameter schema in public metadata yet.

cannibalizationMultiple pages competing for the same query

Multiple pages competing for the same query

No parameter schema in public metadata yet.

opportunity_finderEmerging queries, growing impressions with low CTR, declining performers

Emerging queries, growing impressions with low CTR, declining performers

No parameter schema in public metadata yet.

position_trackingPosition changes over time for specific queries/pages

Position changes over time for specific queries/pages

No parameter schema in public metadata yet.

ctr_anomaliesQueries with abnormal CTR relative to position

Queries with abnormal CTR relative to position

No parameter schema in public metadata yet.

content_decayPages/queries with impressions dropping >50% from historical peak

Pages/queries with impressions dropping >50% from historical peak

No parameter schema in public metadata yet.

weekly_seo_reportAll-in-one report: overview + quick wins + top movers

All-in-one report: overview + quick wins + top movers

No parameter schema in public metadata yet.

indexing_coverageBatch URL inspection with categorized indexing status

Batch URL inspection with categorized indexing status

No parameter schema in public metadata yet.

sitemap_healthSitemap error patterns, freshness, indexed vs submitted ratio

Sitemap error patterns, freshness, indexed vs submitted ratio

No parameter schema in public metadata yet.

add_siteAdd a new site to GSC

Add a new site to GSC

No parameter schema in public metadata yet.

delete_siteRemove a site from GSC

Remove a site from GSC

No parameter schema in public metadata yet.

submit_sitemapSubmit a new sitemap

Submit a new sitemap

No parameter schema in public metadata yet.

delete_sitemapRemove/unsubmit a sitemap

Remove/unsubmit a sitemap

No parameter schema in public metadata yet.

request_indexingAsk Google to crawl a URL via the Indexing API

Ask Google to crawl a URL via the Indexing API

No parameter schema in public metadata yet.

get_indexing_statusWhen a URL was last submitted for indexing

When a URL was last submitted for indexing

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-gsc

mcp-gsc

Google Search Console MCP server — query search analytics, inspect URLs, manage sitemaps & more via natural language.
Built with Bun + TypeScript. Works with Claude, Cursor, and any MCP client.


Quick Start

1. Get Credentials

You need OAuth client credentials from Google Cloud Console.

  1. Go to Google Cloud Console

  2. Create a project (or select existing)

  3. Enable the Google Search Console API:

    • APIs & Services → Library → search "Google Search Console API" → Enable
  4. Configure OAuth consent screen (if not done):

    • APIs & Services → OAuth consent screen → External
    • Fill in app name + your email, add scope https://www.googleapis.com/auth/webmasters
  5. Create credentials:

    • APIs & Services → Credentials → Create Credentials → OAuth client ID
    • Application type: Desktop app (allows localhost redirects automatically)
    • Download the JSON file
  6. Set the credentials path:


View the full README on GitHub

Details

Repository
github.com/pijusz/mcp-gsc
Category
Search & Web Crawling
Package
mcp-gsc
Transport
STDIO
Registry
MCP registry, active

More from pijusz

Related Search & Web Crawling MCP servers

View all
1revolutionarybukhari avatarOpportunity MCPrevolutionarybukhari/opportunity-mcpSearch youth opportunities (scholarships, fellowships, internships) from any AI assistant.1stars
2stevenvo avatarSlack Mcp Serverstevenvo/slack-mcp-serverRead Slack conversations, threads, user info, and search messages from your MCP client.1stars
3theyahia avatarqsearchtheyahia/qsearchMulti-engine search for AI agents. Trust scoring, local corpus, MCP-native. Self-hostable, BYOK.1stars
4tkmd avatarReftrixmcptkmd/reftrixmcpWeb design analysis with 26 MCP tools: layout, motion, quality, semantic search via pgvector1stars
5aamangeldi avatarAamangeldi Dad Jokes Mcpaamangeldi/dad-jokes-mcpGet a random dad joke or search by keyword to fit any moment. Retrieve specific jokes by ID for re…0stars
6cindyloo avatarCindyloo Dropbox Mcp Servercindyloo/dropbox-mcp-serverSearch, browse, and read your Dropbox files. Find documents by name or content, list folders, and…0stars