MCP Search Analytics Server
About
MCP Search Analytics Server is a Model Context Protocol (MCP) server that provides unified access to Google Analytics 4 and Google Search Console data, enabling real-time analytics queries through the MCP interface. It is designed for developers and data analysts who need to…
Explore
- Unified access to Google Analytics 4 and Google Search Console data
- Real-time analytics queries through MCP interface
- Secure credential management via environment variables
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Search Analytics ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Python 3.8+
- Google Cloud Project with Analytics and Search Console APIs enabled
- Google Service Account with appropriate permissions
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp search analytics server": {
"mcp-search-analytics": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"mcp-search-analytics": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}A Model Context Protocol (MCP) server for Google Analytics and Search Console data analysis.
🚀 Features
- Unified access to Google Analytics 4 and Google Search Console data
- Real-time analytics queries through MCP interface
- Secure credential management via environment variables
🔧 Setup
Prerequisites
- Python 3.8+
- Google Cloud Project with Analytics and Search Console APIs enabled
- Google Service Account with appropriate permissions
Installation
1. Clone this repository:
git clone <your-repo-url>
cd mcp-search-analytics
2. Create a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
3. Install dependencies:
pip install -r requirements.txt
Configuration
1. Create environment file:
cp environment.example .env
2. Set up Google Service Account:
- Create a service account in Google Cloud Console
- Download the JSON credentials file
- Enable Google Analytics Reporting API and Search Console API
- Grant necessary permissions to your service account
3. Configure environment variables:
Edit .env file with your actual values:
ANALYTICS_CREDENTIALS_PATH=/path/to/your/credentials.json
GSC_SITE_URL=https://your-website.com
GA4_PROPERTY_ID=your-property-id
Usage
1. Test your credentials:
python test_credentials.py
2. Run the MCP server:
python unified_analytics_server.py
🔐 Security Notes
- Never commit credential files (.json, .env) to version control
- Store credentials securely and use environment variables
- Regularly rotate service account keys
- Follow principle of least privilege for API access
📋 Requirements
See requirements.txt for Python dependencies.
🤝 Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request
📄 License
[Add your license here]
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
