Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/surendranb--google-analytics-mcp/badge.svg)](/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
  1. {
  2. "name": "google-analytics-mcp",
  3. "owner": {
  4. "name": "Surendran B",
  5. "url": "https://github.com/surendranb"
  6. },
  7. "metadata": {
  8. "description": "Google Analytics 4 MCP server for real-time reporting, schema discovery, metric aggregation, and audience insights.",
  9. "version": "2.12.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "google-analytics-mcp",
  14. "source": "./",
  15. "description": "Google Analytics 4 MCP server for real-time reporting, schema discovery, metric aggregation, and audience insights.",
  16. "strict": false
  17. }
  18. ]
  19. }
README.md · README · 126 lines · 1 finding marked
  1. <!-- mcp-name: io.github.surendranb/google-analytics-mcp -->
  2. <p align="center">
  3. <img src="logo.png" alt="Google Analytics MCP Logo" width="120" />
  4. </p>
  5. # Google Analytics 4 (GA4) MCP Server 📊
  6. > **Model Context Protocol (MCP) server for Google Analytics 4: real-time query exploration, schema discovery, metric aggregation, and audience insights for AI agents.**
  7. [![CI](https://github.com/surendranb/google-analytics-mcp/actions/workflows/package-checks.yml/badge.svg)](https://github.com/surendranb/google-analytics-mcp/actions)
  8. [![PyPI version](https://img.shields.io/pypi/v/google-analytics-mcp.svg?style=flat-square&color=blue)](https://pypi.org/project/google-analytics-mcp/)
  9. [![npm version](https://img.shields.io/npm/v/@surendranb/google-analytics-mcp.svg?style=flat-square&color=red)](https://www.npmjs.com/package/@surendranb/google-analytics-mcp)
  10. [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/surendranb/google-analytics-mcp/badge)](https://scorecard.dev/viewer/?site=github.com/surendranb/google-analytics-mcp)
  11. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
  12. 🌐 **Live Documentation & Web Portal**: [https://ga4mcp.com/](https://ga4mcp.com/)
  13. ---
  14. ## ⚡ Quickstart
  15. ```bash
  16. # 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
  17. 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
  18. # Or run directly via your preferred runtime:
  19. uvx google-analytics-mcp
  20. uvx --from google-analytics-mcp ga4-mcp-server
  21. python -m ga4_mcp
  22. npx -y @surendranb/google-analytics-mcp
  23. ```
  24. ---
  25. ---
  26. ## 🤖 Client Setup
  27. ### A. Claude Code (CLI)
  28. ```bash
  29. claude mcp add google-analytics -- uvx google-analytics-mcp
  30. ```
  31. ### B. Cursor & Google Antigravity (`mcp.json`)
  32. ```json
  33. {
  34. "mcpServers": {
  35. "google-analytics": {
  36. "command": "uvx",
  37. "args": ["google-analytics-mcp"]
  38. }
  39. }
  40. }
  41. ```
  42. ### C. Claude Desktop (`claude_desktop_config.json`)
  43. ```json
  44. {
  45. "mcpServers": {
  46. "google-analytics": {
  47. "command": "uvx",
  48. "args": ["google-analytics-mcp"],
  49. "env": {
  50. "GA4_PROPERTY_ID": "your_ga4_property_id",
  51. "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
  52. }
  53. }
  54. }
  55. }
  56. ```
  57. ### D. VS Code (Cline / Roo Code / Continue)
  58. ```json
  59. {
  60. "mcpServers": {
  61. "google-analytics": {
  62. "command": "npx",
  63. "args": ["-y", "@surendranb/google-analytics-mcp"]
  64. }
  65. }
  66. }
  67. ```
  68. ---
  69. ## 🛠️ Tools & Capabilities
  70. | Tool Name | Parameters | Description | Return Type |
  71. |---|---|---|---|
  72. | `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` |
  73. | `list_accounts` | *(none)* | Lists all accessible Google Analytics accounts and permission levels. | `JSON` |
  74. | `list_properties` | `account_id` (optional) | Lists all GA4 properties associated with an account. | `JSON` |
  75. | `get_property_metadata` | `property_id` (optional) | Fetches complete dimension and metric schemas, custom definitions, and compatibility rules. | `JSON` |
  76. | `run_realtime_report` | `metrics` (list), `dimensions` (list) | Queries real-time active users and event counts from the last 30 minutes. | `JSON` |
  77. | `search_skills` | `query` (string) | Searches built-in GA4 analytical playbooks (e-commerce, channel attribution, bot filtering). | `Markdown` |
  78. | `skill_read` | `skill_name` (string) | Dynamically loads procedural skills and analytical guides from GitHub. | `Markdown` |
  79. | `skills_list` | *(none)* | Lists all available live GA4 analytical skills. | `JSON` |
  80. ---
  81. ## 🧠 Dynamic Skills & Guided Playbooks
  82. This server ships with built-in analytical recipes that load dynamically from GitHub:
  83. - `traffic-diagnosis`: Step-by-step root cause analysis for sudden traffic drops.
  84. - `channel-acquisition`: Best-practice channel grouping and attribution modeling.
  85. - `ecommerce-analysis`: Revenue, item purchase rate, and conversion funnel analysis.
  86. - `ai-referral-analysis`: Tracks and isolates referral traffic from ChatGPT, Claude, Perplexity, and Gemini.
  87. ---
  88. ## 🔒 Telemetry & Privacy
  89. 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.
  90. You can opt out anytime by setting either of the following environment variables:
  91. ```bash
  92. export DO_NOT_TRACK=1
  93. # or
  94. export MCP_TELEMETRY_OPT_OUT=1
  95. ```
  96. ---
  97. ## 📄 License
  98. MIT License. See [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.