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.

🌐 Live Documentation & Web Portal: https://ga4.builditwithai.xyz

---

⚡ Quickstart

# 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

---

---

🤖 Client Setup

A. Claude Code (CLI)

claude mcp add google-analytics -- uvx google-analytics-mcp

B. Cursor & Google Antigravity (mcp.json)

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-mcp"]
    }
  }
}

C. Claude Desktop (claude_desktop_config.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)

{
  "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