Supports inspecting a URL's AMP status, mobile usability, and rich results via the URL inspection tools.
Provides integration with the Google Indexing API to notify Google about URL updates or removals, supporting both single and batch notifications.
Offers full API coverage for Google Search Console, including managing sites, submitting sitemaps, and querying comprehensive search performance data like clicks, impressions, CTR, and ranking positions.
gsc-mcp
MCP server for Google Search Console API and Google Indexing API — full API coverage.
When to Use
Task | Tool |
"Check which queries my site ranks for" |
|
"Submit a URL for indexing" |
|
"Find pages with indexing errors" |
|
"Get search performance data for the last 30 days" |
|
"Compare click-through rates between mobile and desktop" |
|
"Submit my sitemap to Google" |
|
"Batch submit URLs for indexing" |
|
For AI agents: See
llms.txtfor a machine-readable summary. Copytemplates/CLAUDE.mdortemplates/AGENTS.mdinto your project to teach your agent about this MCP.
Unlike other GSC MCP servers that only wrap searchAnalytics.query, this server exposes every endpoint available in the Google Search Console and Indexing APIs.
Tools (13)
Sites
Tool | Description |
| List all sites (properties) in your Search Console |
| Get details of a specific site |
| Add a new site (property) |
| Remove a site |
Sitemaps
Tool | Description |
| List all submitted sitemaps for a site |
| Get details of a specific sitemap |
| Submit a sitemap |
| Delete a sitemap |
Search Analytics
Tool | Description |
| Query search performance data (clicks, impressions, CTR, position) with filtering and grouping. Supports hourly data with the |
URL Inspection
Tool | Description |
| Inspect a URL's index status, crawl info, rich results, AMP, and mobile usability |
Indexing API
Tool | Description |
| Notify Google about URL updates or removals |
| Get latest notification status for a URL |
| Batch notify Google about up to 100 URL updates/removals in a single request |
Authentication
Two authentication methods are supported:
Option 1: OAuth2 Refresh Token
{
"mcpServers": {
"gsc-mcp": {
"command": "npx",
"args": ["-y", "@mikusnuz/gsc-mcp"],
"env": {
"GSC_CLIENT_ID": "your-client-id",
"GSC_CLIENT_SECRET": "your-client-secret",
"GSC_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}Required OAuth2 scopes:
https://www.googleapis.com/auth/webmastershttps://www.googleapis.com/auth/indexing
Option 2: Service Account
{
"mcpServers": {
"gsc-mcp": {
"command": "npx",
"args": ["-y", "@mikusnuz/gsc-mcp"],
"env": {
"GSC_SERVICE_ACCOUNT_KEY_PATH": "/path/to/service-account-key.json"
}
}
}
}The service account must be added as an owner or user in Google Search Console for each site.
Setup Guide
OAuth2 Setup
Go to Google Cloud Console
Create a project (or select existing)
Enable Search Console API and Indexing API
Create OAuth 2.0 credentials (Desktop app type)
Use the OAuth Playground to generate a refresh token with scopes:
https://www.googleapis.com/auth/webmastershttps://www.googleapis.com/auth/indexing
Service Account Setup
Go to Google Cloud Console
Create a service account
Download the JSON key file
Enable Search Console API and Indexing API
In Search Console, add the service account email as an owner for your sites
License
MIT