# Google Analytics 4 (GA4) MCP Server

> Model Context Protocol (MCP) server for Google Analytics 4 data exploration, schema discovery, and real-time metrics.

## Installation
- UVX: `uvx google-analytics-mcp`
- NPX: `npx -y google-analytics-mcp`
- Curl: `curl -fsSL https://ga4.builditwithai.xyz/install | bash`
- Documentation: https://ga4.builditwithai.xyz

## Primary Tools
- `get_ga4_data(dimensions, metrics, date_ranges, limit)`: Runs structured reports.
- `list_accounts()`: Lists accessible GA accounts.
- `list_properties(account_id)`: Lists properties.
- `get_property_metadata(property_id)`: Fetches dimensions and metrics schema.
- `run_realtime_report(metrics, dimensions)`: Fetches live active users.
- `search_skills(query)`: Searches analytical recipes.

## Environment Variables
- `GA4_PROPERTY_ID`: Default GA4 property ID.
- `GOOGLE_APPLICATION_CREDENTIALS`: Path to service account JSON key file.
- `DO_NOT_TRACK`: Set to `1` to disable anonymous telemetry.

## Harness guides (verified 2026-10-09; site labels v2.11.4, repo pyproject.toml reads 2.11.5)
- Hub: https://ga4mcp.com/ga4-mcp-for-every-harness/ — one installer path for every client below.
- https://ga4mcp.com/ga4-mcp-for-claude/ — Code via CLI, Desktop via JSON, Cowork through Desktop (site FAQ).
- https://ga4mcp.com/ga4-mcp-for-codex/ — Codex CLI as stdio server.
- https://ga4mcp.com/ga4-mcp-for-cursor/ — Cursor mcp.json entry.
- https://ga4mcp.com/ga4-mcp-for-antigravity/ — Antigravity CLI mcp_config.json.
- https://ga4mcp.com/ga4-mcp-for-antigravity-ide/ — Antigravity IDE MCP Store plus raw config.
- https://ga4mcp.com/ga4-mcp-for-copilot/ — Copilot CLI config.
- https://ga4mcp.com/ga4-mcp-for-deepseek/ — DeepSeek Harness dsh-mcp-client entry.
- https://ga4mcp.com/ga4-mcp-for-devin-desktop/ — Devin MCP config, native path.
- https://ga4mcp.com/ga4-mcp-for-gemini/ — Gemini CLI settings.json; extension root v2.11.1 vs nested v2.5.0 kept distinct.
- https://ga4mcp.com/ga4-mcp-for-goose/ — Goose config.yaml extensions block.
- https://ga4mcp.com/ga4-mcp-for-hermes/ — Hermes config.yaml mcp_servers block.
- https://ga4mcp.com/ga4-mcp-for-kiro/ — Kiro mcp.json, workspace and user scopes.
- https://ga4mcp.com/ga4-mcp-for-openclaw/ — openclaw mcp add line; bundle plugins/openclaw/plugin.json v2.4.1 kept distinct.
- https://ga4mcp.com/ga4-mcp-for-opencode/ — opencode.jsonc block.
- https://ga4mcp.com/ga4-mcp-for-pi/ — Pi agent-dir mcp.json block.
- https://ga4mcp.com/ga4-mcp-for-vscode/ — VS Code .vscode/mcp.json block (Cline, Roo).
- https://ga4mcp.com/ga4-mcp-for-zcode/ — ZCode MCP block.
- https://ga4mcp.com/ga4-mcp-for-zed/ — Zed context_servers block.

## Plugin bundles (verified 2026-10-09)
- Hub: https://ga4mcp.com/ga4-plugins/ — server vs plugin split plus all three bundles.
- https://ga4mcp.com/ga4-plugin-for-claude-code/ — .claude-plugin/plugin.json v2.11.1.
- https://ga4mcp.com/ga4-plugin-for-gemini/ — root gemini-extension.json v2.11.1; nested gemini-extension/gemini-extension.json v2.5.0.
- https://ga4mcp.com/ga4-plugin-for-harness/ — plugins/openclaw/plugin.json v2.4.1, entry ga4-mcp-server over stdio.