Google Search Console MCP Server
Provides comprehensive access to Google Search Console data with enhanced analytics capabilities, including search performance metrics, advanced filtering with regex support, multi-dimensional analysis (query, page, country, device, search appearance), and automatic detection of SEO optimization opportunities through quick wins analysis.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Google Search Console MCP Server
A Model Context Protocol (MCP) server providing comprehensive access to Google Search Console data with enhanced analytics capabilities.
Sponsored by
Features
Enhanced Search Analytics: Retrieve up to 25,000 rows of performance data
Advanced Filtering: Support for regex patterns and multiple filter operators
Quick Wins Detection: Automatically identify optimization opportunities
Rich Dimensions: Query, page, country, device, and search appearance analysis
Flexible Date Ranges: Customizable reporting periods with historical data access
Related MCP server: Google Search Console MCP Server
Prerequisites
Node.js 18 or later
Google Cloud Project with Search Console API enabled
Service Account credentials with Search Console access
Installation
Installing via Smithery
To install Google Search Console for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-server-gsc --client claudeManual Installation
npm install mcp-server-gscAuthentication Setup
To obtain Google Search Console API credentials:
Visit the Google Cloud Console
Create a new project or select an existing one
Enable the API:
Go to "APIs & Services" > "Library"
Search for and enable "Search Console API"
Create credentials:
Navigate to "APIs & Services" > "Credentials"
Click "Create Credentials" > "Service Account"
Fill in the service account details
Create a new key in JSON format
The credentials file (.json) will download automatically
Grant access:
Open Search Console
Add the service account email (format: name@project.iam.gserviceaccount.com) as a property administrator
Usage
Claude Desktop Configuration
{
"mcpServers": {
"gsc": {
"command": "npx",
"args": ["-y", "mcp-server-gsc"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
}
}
}
}Available Tools
search_analytics
Get comprehensive search performance data from Google Search Console with enhanced analytics capabilities.
Required Parameters:
siteUrl: Site URL (format:http://www.example.com/orsc-domain:example.com)startDate: Start date (YYYY-MM-DD)endDate: End date (YYYY-MM-DD)
Optional Parameters:
dimensions: Comma-separated list (query,page,country,device,searchAppearance,date)type: Search type (web,image,video,news,discover,googleNews)aggregationType: Aggregation method (auto,byNewsShowcasePanel,byProperty,byPage)rowLimit: Maximum rows to return (default: 1000, max: 25000)dataState: Data freshness (allorfinal, default:final)
Filter Parameters:
pageFilter: Filter by page URL (supports regex withregex:prefix)queryFilter: Filter by search query (supports regex withregex:prefix)countryFilter: Filter by country ISO 3166-1 alpha-3 code (e.g.,USA,CHN)deviceFilter: Filter by device type (DESKTOP,MOBILE,TABLET)searchAppearanceFilter: Filter by search feature (e.g.,AMP_BLUE_LINK,AMP_TOP_STORIES)filterOperator: Operator for filters (equals,contains,notEquals,notContains,includingRegex,excludingRegex)
Quick Wins Detection:
detectQuickWins: Enable automatic detection of optimization opportunities (default:false)quickWinsConfig: Configuration for quick wins detection:positionRange: Position range to consider (default:[4, 20])minImpressions: Minimum impressions threshold (default:100)minCtr: Minimum CTR percentage (default:1)
Example - Basic Query:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "query,page",
"rowLimit": 5000
}Example - Advanced Filtering with Regex:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "page,query",
"queryFilter": "regex:(AI|machine learning|ML)",
"filterOperator": "includingRegex",
"deviceFilter": "MOBILE",
"rowLimit": 10000
}Example - Quick Wins Detection:
{
"siteUrl": "https://example.com",
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": "query,page",
"detectQuickWins": true,
"quickWinsConfig": {
"positionRange": [4, 15],
"minImpressions": 500,
"minCtr": 2
}
}License
MIT
Contributing
Contributions are welcome! Please read our contributing guidelines before submitting pull requests.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Turn Search Console data into SEO actions, content, publishing, indexing, and AI insights.
AI SEO agent on your Google Search Console data: audits, quick wins, content, WordPress publishing.
Google Search Console for AI assistants: traffic, rankings, indexing and page checks. Read-only.
Query your Google Search Console, GA4 and Bing Webmaster data across every site you run.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceProvides comprehensive access to Google Search Console data with enhanced analytics capabilities, supporting up to 25,000 rows of performance data, advanced filtering with regex patterns, and automatic quick wins detection for SEO optimization opportunities.2-
- AlicenseNot gradedqualityDmaintenanceProvides access to Google Search Console to retrieve and analyze search performance data including queries, pages, and rankings. It enables users to perform rich data analysis through customizable reporting periods and dimensions using the Search Console API.MIT
- FlicenseAqualityDmaintenanceIntegrates with Google Search Console to enable querying search analytics, comparing performance periods, generating visual reports, and identifying SEO optimization opportunities through natural language.59-
- FlicenseNot gradedqualityDmaintenanceEnables querying Google Search Console data via natural language, providing tools for site traffic analysis, page changes, and optimization opportunities.-