What can you do with this server?

This server connects Google Search Console to AI assistants, enabling SEO data querying, indexing audits, sitemap management, and full site audits through natural language. Property Management * List all GSC properties, get detailed site information, add or remove properties (disabled by default), and re-authenticate to switch Google accounts. Search Analytics & Performance * Retrieve top queries and pages with clicks, impressions, CTR, and position * Get performance overviews with daily trends, period-over-period comparisons, and page-specific query analysis * Advanced analytics with filters by country, device, query, or page, with sorting and pagination support URL Inspection & Indexing * Inspect individual URLs for crawl/index status and rich results eligibility * Batch-inspect up to 10 URLs at once and get a prioritized fix list for indexing issues Sitemap Management * List, inspect, submit, and delete sitemaps (deletion disabled by default) * View errors, warnings, and submitted-vs-indexed breakdowns per sitemap Pre-Built Chained Skill Workflows * Weekly SEO Report — 28-day summary with period-over-period comparison * Indexing Audit — batch-inspects top pages and returns a prioritized fix list * Cannibalization Check — finds queries where multiple pages compete * Content Opportunities — surfaces position 11–20 queries with high impressions and low CTR * Device Performance Split — compares mobile vs. desktop vs. tablet * Country Opportunities — identifies top and under-performing markets * Branded vs. Non-Branded — splits query types to reveal true organic growth * New vs. Lost Queries — finds queries that are brand-new or have disappeared * Content Decay Report — identifies pages on a 90-day gradual traffic decline * Sitemap Health Check — audits errors, warnings, and indexing gaps * Multi-Property Comparison — ranks and compares every property in the account * Full SEO Audit — chains indexing, sitemap, cannibalization, content-decay, and lost-query checks, cross-referencing findings to identify root causes Safety note: Destructive operations (adding/deleting sites or sitemaps) are disabled by default and require explicit configuration to enable.

Which integrations are available for this server?

Provides tools and skills to query SEO data, audit indexing, manage sitemaps, run performance reports, check content cannibalization, analyze device and country splits, detect content decay, and perform full cross-referenced SEO audits across Google Search Console properties.

How do I use Google Search Console (GSC) MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Google Search Console (GSC) MCP list my GSC properties" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Google Search Console (GSC) MCP

by amirjahfar1

Overview Schema Related Servers Score Discussions

Python

Remote

This server connects Google Search Console to AI assistants, enabling SEO data querying, indexing audits, sitemap management, and full site audits through natural language.

Property Management

List all GSC properties, get detailed site information, add or remove properties (disabled by default), and re-authenticate to switch Google accounts.

Search Analytics & Performance

Retrieve top queries and pages with clicks, impressions, CTR, and position
Get performance overviews with daily trends, period-over-period comparisons, and page-specific query analysis
Advanced analytics with filters by country, device, query, or page, with sorting and pagination support

URL Inspection & Indexing

Inspect individual URLs for crawl/index status and rich results eligibility
Batch-inspect up to 10 URLs at once and get a prioritized fix list for indexing issues

Sitemap Management

List, inspect, submit, and delete sitemaps (deletion disabled by default)
View errors, warnings, and submitted-vs-indexed breakdowns per sitemap

Pre-Built Chained Skill Workflows

Weekly SEO Report — 28-day summary with period-over-period comparison
Indexing Audit — batch-inspects top pages and returns a prioritized fix list
Cannibalization Check — finds queries where multiple pages compete
Content Opportunities — surfaces position 11–20 queries with high impressions and low CTR
Device Performance Split — compares mobile vs. desktop vs. tablet
Country Opportunities — identifies top and under-performing markets
Branded vs. Non-Branded — splits query types to reveal true organic growth
New vs. Lost Queries — finds queries that are brand-new or have disappeared
Content Decay Report — identifies pages on a 90-day gradual traffic decline
Sitemap Health Check — audits errors, warnings, and indexing gaps
Multi-Property Comparison — ranks and compares every property in the account
Full SEO Audit — chains indexing, sitemap, cannibalization, content-decay, and lost-query checks, cross-referencing findings to identify root causes

Safety note: Destructive operations (adding/deleting sites or sitemaps) are disabled by default and require explicit configuration to enable.

Google Search Console (GSC) MCP

Maintained by Amir Ali.

A Model Context Protocol (MCP) server that connects Google Search Console to AI assistants — query your SEO data, audit indexing, manage sitemaps, and run full site audits through natural language. Works with Claude Code, Claude Desktop, Cursor, Codex CLI, and any other MCP-compatible client.

What's Different in This Edition

This fork keeps the full 20-tool GSC API surface from the upstream project and adds 8 new skills plus a master audit skill that cross-references findings across checks instead of reporting them in isolation:

device-performance-split, country-opportunities, branded-vs-nonbranded — deeper analytics cuts the base tools don't surface on their own
new-vs-lost-queries, content-decay-report, sitemap-health-check — trend and health checks the original skill set didn't cover
multi-property-comparison — portfolio-level view across every property in the account
full-seo-audit — chains indexing, sitemap, cannibalization, content-decay, and lost-query checks together and cross-references the results to point at the actual root cause (e.g. a "decaying" page that's really being cannibalized by a newer page, not losing to competitors)

See Available Skills below for the full list, and SETUP.md for the install walkthrough.

Related MCP server: Google Search Console MCP Server

Available Tools

All 19 tools covering the full GSC API surface:

Tool	What It Does	What You Need to Provide
`get_capabilities`	Lists all tools and shows auth status — call this first if unsure	Nothing
`list_properties`	Shows all your GSC properties	Nothing
`get_site_details`	Details about a specific site	Site URL
`add_site`	Add a new property to the account (disabled by default)	Site URL
`delete_site`	Remove a property from the account (disabled by default)	Site URL
`get_search_analytics`	Top queries and pages with clicks, impressions, CTR, position	Site URL, time period
`get_performance_overview`	Summary of site performance with daily trend	Site URL, time period
`compare_search_periods`	Compare performance between two time periods	Site URL, two date ranges
`get_search_by_page_query`	Search terms driving traffic to a specific page	Site URL, page URL
`get_advanced_search_analytics`	Analytics with filters by country, device, query, page	Site URL
`inspect_url_enhanced`	Detailed crawl/index status for a URL	Site URL, page URL
`batch_url_inspection`	Inspect up to 10 URLs at once	Site URL, list of URLs
`check_indexing_issues`	Check multiple URLs for indexing problems	Site URL, list of URLs
`get_sitemaps`	Lists all sitemaps for a site	Site URL
`list_sitemaps_enhanced`	Detailed sitemap info including errors and warnings	Site URL
`get_sitemap_details`	Submitted-vs-indexed breakdown for one sitemap	Site URL, sitemap URL
`submit_sitemap`	Submit a new sitemap	Site URL, sitemap URL
`delete_sitemap`	Remove a sitemap (disabled by default)	Site URL, sitemap URL
`manage_sitemaps`	Submit or delete sitemaps via one action tool	Site URL, action
`reauthenticate`	Re-run the OAuth browser login (switch accounts)	Nothing

Destructive tools (add_site, delete_site, delete_sitemap) are disabled by default — see Safety.

Tool usage examples

10 sample prompts, each exercising a different tool directly (no skill involved):

Tool	Sample Prompt
`list_properties`	"List all my GSC properties and tell me which ones I have full access to."
`get_site_details`	"Show me the verification and ownership details for example.com."
`get_search_analytics`	"Show me the top 20 search queries for mywebsite.com in the last 30 days, and highlight any with CTR below 2%."
`get_performance_overview`	"Give me a performance overview of mywebsite.com for the last 28 days, including the daily trend."
`compare_search_periods`	"Compare mywebsite.com's performance between January and February. What queries improved the most?"
`get_search_by_page_query`	"What search terms are driving traffic to mywebsite.com/pricing?"
`get_advanced_search_analytics`	"Show queries with high impressions but position below 10, filtered to mobile traffic in the US."
`inspect_url_enhanced`	"Do a full crawl and index inspection of mywebsite.com/landing-page."
`batch_url_inspection`	"Check the indexing status of these 5 pages: [list URLs]."
`get_sitemaps`	"List all sitemaps submitted for mywebsite.com and flag any with errors."

Available Skills

Skills are ready-made workflows that chain the tools above together. They're auto-loaded in Claude Code via .claude-plugin/plugin.json.

Core reports

Skill	What it does
`seo-weekly-report`	Full 28-day performance summary with period-over-period comparison and top queries
`indexing-audit`	Batch-inspects top pages and returns a prioritized indexing fix list
`cannibalization-check`	Finds queries where multiple pages compete; recommends which to consolidate
`content-opportunities`	Surfaces position 11–20 queries with high impressions and low CTR

Deeper analytics cuts

Skill	What it does
`device-performance-split`	Compares mobile vs desktop vs tablet performance, flags mobile-specific gaps
`country-opportunities`	Finds top and under-performing countries/markets
`branded-vs-nonbranded`	Splits branded vs non-branded queries to reveal true organic growth
`new-vs-lost-queries`	Finds queries that are brand-new or have completely disappeared, not just declined

Health & trend checks

Skill	What it does
`content-decay-report`	Finds pages on a 90-day gradual traffic decline — refresh candidates
`sitemap-health-check`	Audits sitemap errors/warnings and the submitted-vs-indexed gap
`multi-property-comparison`	Ranks and compares every property in the account side by side

Master audit

Skill	What it does
`full-seo-audit`	Runs indexing, sitemap, cannibalization, content-decay, and lost-query checks together, then cross-references the findings to point at root cause instead of listing symptoms in isolation

Getting Started

Full step-by-step walkthrough (Google Cloud credentials, install, and client config) is in SETUP.md.

Quick summary:

Get Google API credentials — OAuth client ID (recommended) or a service account key, from Google Cloud Console.
Clone this repo and install dependencies — this fork's extra skills only exist in this repo, so use the clone method, not the uvx/PyPI package (see note in SETUP.md).
Point your MCP client at it — Claude Code picks up .mcp.json automatically at the project root; see SETUP.md for Claude Desktop / Cursor configs.
Test — ask your assistant "List my GSC properties." If you see your properties, it's working.

Environment Variables Reference

Variable	Required	Default	Description
`GSC_OAUTH_CLIENT_SECRETS_FILE`	OAuth only	—	Absolute path to your OAuth client secrets JSON
`GSC_CREDENTIALS_PATH`	Service account only	—	Absolute path to your service account JSON key
`GSC_SKIP_OAUTH`	No	`false`	Set to `"true"` to force service account auth and skip OAuth entirely
`GSC_DATA_STATE`	No	`"all"`	`"all"` matches the GSC dashboard. `"final"` returns only confirmed data (2–3 day lag)
`GSC_ALLOW_DESTRUCTIVE`	No	`false`	Set to `"true"` to enable `add_site` / `delete_site` / `delete_sitemap`

Skill Usage Examples

10 sample prompts that trigger the bundled skills (chained tool workflows) instead of a single tool:

Goal	Sample Prompt
Weekly report	"Run the SEO weekly report for example.com"
Full audit	"Run a full SEO audit on example.com"
Cannibalization	"Check for keyword cannibalization on example.com"
Indexing	"Audit indexing for my top pages"
Content ideas	"Find content opportunities for example.com"
Mobile vs desktop	"Compare mobile and desktop performance for example.com"
Lost visibility	"Show me new and lost queries for example.com this month"
Content decay	"Which pages on example.com are losing traffic gradually?"
Sitemap health	"Check sitemap health for example.com"
Multi-site	"Compare performance across all my GSC properties"

Safety: Destructive Operations

By default, add_site, delete_site, and delete_sitemap are disabled. To enable them, set:

"GSC_ALLOW_DESTRUCTIVE": "true"

Troubleshooting

See the Troubleshooting section in SETUP.md for spawn ENOENT errors, auth failures, and client-specific config issues.

License

MIT License — see LICENSE.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/amirjahfar1/Google-Search-Console-GSC-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server