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…
Details
- Author
- dexter480
- GitHub stars
- 2
- Downloads
- 431
- Categories
- Search
Jump to
- Unified access to GA4 and Search Console data
- Real‑time analytics queries via MCP interface
- Secure credential management through environment variables
- Built‑in credential testing script
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
Install Python dependencies (Python 3.8+ required), configure environment variables for your Google service account credentials, Search Console site URL, and GA4 property ID in a .env file, then run the server with python unified_analytics_server.py. Test your credentials first with python test_credentials.py.
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"
]
}
}MCP Search Analytics Server
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.
