Google Analytics 4 Server

FreeNot checked

Enables managing Google Analytics 4 properties, data streams, conversions, and running reports using natural language through the Admin and Data APIs.

by stucchi

GitHub Embed

About

Enables managing Google Analytics 4 properties, data streams, conversions, and running reports using natural language through the Admin and Data APIs.

README

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

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

Claude Desktop

Add to claude_desktop_config.json:

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

From source

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

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.

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

from github.com/stucchi/mcp-google-analytics

Install Google Analytics 4 Server in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install google-analytics-4-mcp-server

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add google-analytics-4-mcp-server -- uvx google-analytics-4-mcp

FAQ

Is Google Analytics 4 Server MCP free?

Yes, Google Analytics 4 Server MCP is free — one-click install via Unyly at no cost.

Does Google Analytics 4 Server need an API key?

No, Google Analytics 4 Server runs without API keys or environment variables.

Is Google Analytics 4 Server hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Google Analytics 4 Server in Claude Desktop, Claude Code or Cursor?

Open Google Analytics 4 Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.