Google Search Console
Provides AI agents with read-only access to Google Search Console data, including search analytics, index coverage, and sitemap status. It enables users to query clicks, impressions, and ranking performance or check URL indexing status through natura
What is Google Search Console?
Google Search Console is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides ai agents with read-only access to google search console data, including search analytics, index coverage, and sitemap status. it enables users to query clicks, impressions, and ranking perfo...
Provides AI agents with read-only access to Google Search Console data, including search analytics, index coverage, and sitemap status. It enables users to query clicks, impressions, and ranking performance or check URL indexing status through natura
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides AI agents with read-only access to Google Search Co
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @sarahpark/google-search-console-mcpManual Installation
npx -y @sarahpark/google-search-console-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Search Console
The Google Search Console MCP server gives AI agents read-only access to your Google Search Console data via a single powerful `search_analytics` tool, enabling natural-language queries over clicks, impressions, CTR, and average position broken down by query, page, country, device, and date. It supports advanced filtering with regex operators and can surface quick-win optimization opportunities automatically. SEO professionals and developers use it to analyze search performance, diagnose indexing issues, and identify ranking opportunities without leaving their AI client.
Prerequisites
- Node.js 16+ with npx installed
- A Google Cloud project with the Google Search Console API enabled
- A service account with the JSON credentials file downloaded (or OAuth credentials configured)
- Your site verified and added to Google Search Console
- An MCP-compatible client such as Claude Desktop
Enable the Search Console API
In the Google Cloud Console, enable the Google Search Console API for your project and create a service account. Download the JSON credentials file.
Grant service account access to your property
In Google Search Console, go to Settings > Users and permissions and add the service account email as a Restricted or Full user for your property.
Install the MCP server package
Install mcp-server-gsc globally or use it directly with npx.
npm install -g mcp-server-gsc
# or use npx without installing:
# npx -y mcp-server-gscConfigure your MCP client
Add the server to your claude_desktop_config.json, pointing GOOGLE_APPLICATION_CREDENTIALS to your service account JSON file.
{
"mcpServers": {
"gsc": {
"command": "npx",
"args": ["-y", "mcp-server-gsc"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account.json"
}
}
}
}Restart Claude Desktop and test
Restart your MCP client. Ask Claude to pull search performance data for your site to verify the connection.
Google Search Console Examples
Client configuration
Claude Desktop configuration for the Google Search Console MCP server using a service account credentials file.
{
"mcpServers": {
"gsc": {
"command": "npx",
"args": ["-y", "mcp-server-gsc"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/Users/yourname/keys/gsc-service-account.json"
}
}
}
}Prompts to try
Example prompts for analyzing search performance data with Claude.
- "Show me the top 20 queries by clicks for https://example.com/ over the last 30 days."
- "Which pages on my site have the highest impressions but lowest CTR this month?"
- "Break down my search traffic by country for the last 28 days."
- "Find quick-win opportunities where I rank in positions 4-10 with high impressions."Troubleshooting Google Search Console
403 Permission Denied when querying search data
Confirm the service account email has been added as a user to the correct Search Console property. It can take a few minutes for permissions to propagate.
GOOGLE_APPLICATION_CREDENTIALS file not found at startup
Use an absolute file path in your MCP config, not a relative or home-directory path like ~/keys/file.json. The shell tilde expansion does not work in JSON config values.
The search_analytics tool returns no rows
Verify the siteUrl parameter exactly matches a verified property in your Search Console account, including the protocol and trailing slash (e.g., `https://www.example.com/`). Domain properties use the format `sc-domain:example.com`.
Frequently Asked Questions about Google Search Console
What is Google Search Console?
Google Search Console is a Model Context Protocol (MCP) server that provides ai agents with read-only access to google search console data, including search analytics, index coverage, and sitemap status. it enables users to query clicks, impressions, and ranking performance or check url indexing status through natura It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Search Console?
Install via npm with the command: npx -y @sarahpark/google-search-console-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Google Search Console?
Google Search Console works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Search Console free to use?
Yes, Google Search Console is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Google Search Console Alternatives — Similar Analytics Servers
Looking for alternatives to Google Search Console? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Google Search Console in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Google Search Console?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.