Google Analytics 4

Name: Google Analytics 4
Author: stucchi

数据与存储

by stucchi

Manage GA4 properties, data streams, conversions, and run reports via Admin & Data APIs.

GitHub

什么是 Google Analytics 4？

Manage GA4 properties, data streams, conversions, and run reports via Admin & Data APIs.

README

Google Analytics 4 MCP Server

MCP server for Google Analytics 4 — create properties, configure data streams, manage conversions, and run reports via the Admin & Data APIs.

Setup (one-time, ~3 minutes)

Google Cloud Console → IAM & Admin → Service Accounts
- Create a service account (any name)
- Click it → Keys → Add Key → JSON → Download
Enable APIs in your GCP project:
- Google Analytics Admin API
- Google Analytics Data API
GA4 Admin → Property Access Management → Add the service account email (from the JSON) as Editor
Configure credentials (pick one):
- Option A (recommended): Copy the JSON content into the GA_CREDENTIALS env var in your MCP config
- Option B: Save the file to ~/.google-analytics-4-mcp/credentials.json

Done. No browser flow, no consent screen, no tokens to refresh.

Installation

Claude Code

bash

claude mcp add google-analytics -e GA_CREDENTIALS='{"type":"service_account",...}' -- uvx google-analytics-4-mcp

Claude Desktop

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "google-analytics": {
      "command": "uvx",
      "args": ["google-analytics-4-mcp"],
      "env": {
        "GA_CREDENTIALS": "{\"type\":\"service_account\",\"project_id\":\"...\", ...}"
      }
    }
  }
}

From source

bash

git clone https://github.com/stucchi/mcp-google-analytics.git
cd mcp-google-analytics
uv run google-analytics-4-mcp

Getting Started

Check auth: Call check_auth_status to verify the service account is configured
List accounts: Call list_accounts to see your GA4 accounts
Setup a property: Use create_property → create_web_data_stream → get_tracking_snippet
Query data: Use run_report with dimensions and metrics

Tools (23)

Auth

Tool	Description
`check_auth_status`	Verify service account is configured and valid

Admin API

Tool	Description
`list_accounts`	List accessible GA4 accounts
`list_properties`	List properties for an account
`create_property`	Create a GA4 property
`get_property`	Get property details
`delete_property`	Soft-delete a property
`list_data_streams`	List data streams
`create_web_data_stream`	Create web stream → get Measurement ID
`delete_data_stream`	Delete a data stream
`get_tracking_snippet`	Generate gtag.js HTML snippet
`list_key_events`	List conversion events
`create_key_event`	Mark event as conversion
`delete_key_event`	Remove conversion
`list_custom_dimensions`	List custom dimensions
`create_custom_dimension`	Create custom dimension
`list_custom_metrics`	List custom metrics
`create_custom_metric`	Create custom metric
`list_google_ads_links`	List Google Ads links
`create_google_ads_link`	Link Google Ads account
`get_measurement_protocol_secret`	Get/create Measurement Protocol secret

Data API

Tool	Description
`run_report`	Run report with dimensions, metrics, dates, filters
`run_realtime_report`	Real-time active users and events
`get_metadata`	List available dimensions and metrics

Environment Variables

Variable	Default	Description
`GA_CREDENTIALS`	—	Service Account JSON key content (copy-paste the entire JSON)
`GA_CREDENTIALS_PATH`	`~/.google-analytics-4-mcp/credentials.json`	Alternative: path to the JSON key file

GA_CREDENTIALS takes priority over GA_CREDENTIALS_PATH.

Example Usage

code

You: "Set up Google Analytics for my website https://mcpadvisor.stucchi.consulting"

Assistant calls: list_accounts → create_property → create_web_data_stream → get_tracking_snippet

Result: Property created with Measurement ID G-XXXXXXXXXX and ready-to-paste HTML snippet.

code

You: "Show me the top 10 countries by sessions in the last 7 days"

Assistant calls: run_report(property_id="...", dimensions=["country"], metrics=["sessions"], start_date="7daysAgo", limit=10)

License

MIT

常见问题