Back to search
google-analytics-mcp
MCP serverGitHubIncomplete
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/surendranb--google-analytics-mcp)HTML
<a href="/listings/surendranb--google-analytics-mcp"><img src="/api/listings/surendranb--google-analytics-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf) curl -fsSL "https://ga4.builditwithai.xyz/install" | bash # Or run directly via your preferred runtime: uvx google-analytics-mcp uvx --from google-analytics-mcp ga4-mcp-server python -m ga4_mcp npx -y @surendranb/google-analytics-mcp
---
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 19 lines
- {
- "name": "google-analytics-mcp",
- "owner": {
- "name": "Surendran B",
- "url": "https://github.com/surendranb"
- },
- "metadata": {
- "description": "Google Analytics 4 MCP server for real-time reporting, schema discovery, metric aggregation, and audience insights.",
- "version": "2.12.0"
- },
- "plugins": [
- {
- "name": "google-analytics-mcp",
- "source": "./",
- "description": "Google Analytics 4 MCP server for real-time reporting, schema discovery, metric aggregation, and audience insights.",
- "strict": false
- }
- ]
- }
README.md · README · 126 lines · 1 finding marked
- <!-- mcp-name: io.github.surendranb/google-analytics-mcp -->
- <p align="center">
- <img src="logo.png" alt="Google Analytics MCP Logo" width="120" />
- </p>
- # Google Analytics 4 (GA4) MCP Server 📊
- > **Model Context Protocol (MCP) server for Google Analytics 4: real-time query exploration, schema discovery, metric aggregation, and audience insights for AI agents.**
- [](https://github.com/surendranb/google-analytics-mcp/actions)
- [](https://pypi.org/project/google-analytics-mcp/)
- [](https://www.npmjs.com/package/@surendranb/google-analytics-mcp)
- [](https://scorecard.dev/viewer/?site=github.com/surendranb/google-analytics-mcp)
- [](LICENSE)
- 🌐 **Live Documentation & Web Portal**: [https://ga4mcp.com/](https://ga4mcp.com/)
- ---
- ## ⚡ Quickstart
- ```bash
- # 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
- curl -fsSL "https://ga4.builditwithai.xyz/install" | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 24 on GitHub
- # Or run directly via your preferred runtime:
- uvx google-analytics-mcp
- uvx --from google-analytics-mcp ga4-mcp-server
- python -m ga4_mcp
- npx -y @surendranb/google-analytics-mcp
- ```
- ---
- ---
- ## 🤖 Client Setup
- ### A. Claude Code (CLI)
- ```bash
- claude mcp add google-analytics -- uvx google-analytics-mcp
- ```
- ### B. Cursor & Google Antigravity (`mcp.json`)
- ```json
- {
- "mcpServers": {
- "google-analytics": {
- "command": "uvx",
- "args": ["google-analytics-mcp"]
- }
- }
- }
- ```
- ### C. Claude Desktop (`claude_desktop_config.json`)
- ```json
- {
- "mcpServers": {
- "google-analytics": {
- "command": "uvx",
- "args": ["google-analytics-mcp"],
- "env": {
- "GA4_PROPERTY_ID": "your_ga4_property_id",
- "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
- }
- }
- }
- }
- ```
- ### D. VS Code (Cline / Roo Code / Continue)
- ```json
- {
- "mcpServers": {
- "google-analytics": {
- "command": "npx",
- "args": ["-y", "@surendranb/google-analytics-mcp"]
- }
- }
- }
- ```
- ---
- ## 🛠️ Tools & Capabilities
- | Tool Name | Parameters | Description | Return Type |
- |---|---|---|---|
- | `get_ga4_data` | `dimensions` (list), `metrics` (list), `date_ranges` (list), `limit` (int) | Runs multi-dimensional GA4 reports with automated metric totals and server-side aggregation. | `JSON / Markdown` |
- | `list_accounts` | *(none)* | Lists all accessible Google Analytics accounts and permission levels. | `JSON` |
- | `list_properties` | `account_id` (optional) | Lists all GA4 properties associated with an account. | `JSON` |
- | `get_property_metadata` | `property_id` (optional) | Fetches complete dimension and metric schemas, custom definitions, and compatibility rules. | `JSON` |
- | `run_realtime_report` | `metrics` (list), `dimensions` (list) | Queries real-time active users and event counts from the last 30 minutes. | `JSON` |
- | `search_skills` | `query` (string) | Searches built-in GA4 analytical playbooks (e-commerce, channel attribution, bot filtering). | `Markdown` |
- | `skill_read` | `skill_name` (string) | Dynamically loads procedural skills and analytical guides from GitHub. | `Markdown` |
- | `skills_list` | *(none)* | Lists all available live GA4 analytical skills. | `JSON` |
- ---
- ## 🧠 Dynamic Skills & Guided Playbooks
- This server ships with built-in analytical recipes that load dynamically from GitHub:
- - `traffic-diagnosis`: Step-by-step root cause analysis for sudden traffic drops.
- - `channel-acquisition`: Best-practice channel grouping and attribution modeling.
- - `ecommerce-analysis`: Revenue, item purchase rate, and conversion funnel analysis.
- - `ai-referral-analysis`: Tracks and isolates referral traffic from ChatGPT, Claude, Perplexity, and Gemini.
- ---
- ## 🔒 Telemetry & Privacy
- This package collects anonymous, non-PII diagnostic telemetry (command executions, latency, error codes) to improve tool reliability. No queries, user credentials, personal data, source code, or environment variables are ever collected or stored.
- You can opt out anytime by setting either of the following environment variables:
- ```bash
- export DO_NOT_TRACK=1
- # or
- export MCP_TELEMETRY_OPT_OUT=1
- ```
- ---
- ## 📄 License
- MIT License. See [LICENSE](LICENSE) for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.