Facilitates access to Google search analytics data, allowing for detailed reporting on search traffic and performance across web, image, video, and news search types.
Uses Google Cloud Platform for API management and Service Account-based authentication to securely access Search Console data.
Provides tools to retrieve and analyze search performance data, including metrics for queries, pages, countries, and devices over customizable reporting periods.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Search Console MCP ServerShow me the top 10 queries for https://example.com from last month"
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 MCP Server
A Model Context Protocol (MCP) server providing access to Google Search Console.
Features
Search analytics data retrieval with dimensions support
Rich data analysis with customizable reporting periods
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:
Manual Installation
Authentication 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
Available Tools
search_analytics
Get search performance data from Google Search Console with customizable parameters:
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)type: Search type (web,image,video,news)aggregationType: Aggregation method (auto,byNewsShowcasePanel,byProperty,byPage)rowLimit: Maximum rows to return (default: 1000)
Example:
License
MIT
Contributing
Contributions are welcome! Please read our contributing guidelines before submitting pull requests.