stucchi avatar

Google Analytics 4

stucchi/mcp-google-analytics

Wraps both the GA4 Admin and Data APIs so you can spin up properties, configure web data streams, pull tracking snippets, and run dimension/metric reports without leaving Claude. The setup uses a GCP service account with JSON key auth, sidestepping the usual OAuth dance. You get 23 tools covering the full lifecycle: create properties and streams, mark events as conversions, define custom dimensions, link Google Ads accounts, and query historical or real-time data. Reach for this when you're provisioning analytics infrastructure or need to pull session breakdowns by country, device, or custom parameters directly in a conversation.

tools
23
transport
STDIO
env vars
2
last updated
Mar 1, 2026

Tools

23 tools

Public tool metadata for what this MCP can expose to an agent.

check_auth_statusVerify service account is configured and valid

Verify service account is configured and valid

No parameter schema in public metadata yet.

list_accountsList accessible GA4 accounts

List accessible GA4 accounts

No parameter schema in public metadata yet.

list_propertiesList properties for an account

List properties for an account

No parameter schema in public metadata yet.

create_propertyCreate a GA4 property

Create a GA4 property

No parameter schema in public metadata yet.

get_propertyGet property details

Get property details

No parameter schema in public metadata yet.

delete_propertySoft-delete a property

Soft-delete a property

No parameter schema in public metadata yet.

list_data_streamsList data streams

List data streams

No parameter schema in public metadata yet.

create_web_data_streamCreate web stream → get Measurement ID

Create web stream → get Measurement ID

No parameter schema in public metadata yet.

delete_data_streamDelete a data stream

Delete a data stream

No parameter schema in public metadata yet.

get_tracking_snippetGenerate gtag.js HTML snippet

Generate gtag.js HTML snippet

No parameter schema in public metadata yet.

list_key_eventsList conversion events

List conversion events

No parameter schema in public metadata yet.

create_key_eventMark event as conversion

Mark event as conversion

No parameter schema in public metadata yet.

delete_key_eventRemove conversion

Remove conversion

No parameter schema in public metadata yet.

list_custom_dimensionsList custom dimensions

List custom dimensions

No parameter schema in public metadata yet.

create_custom_dimensionCreate custom dimension

Create custom dimension

No parameter schema in public metadata yet.

list_custom_metricsList custom metrics

List custom metrics

No parameter schema in public metadata yet.

create_custom_metricCreate custom metric

Create custom metric

No parameter schema in public metadata yet.

list_google_ads_linksList Google Ads links

List Google Ads links

No parameter schema in public metadata yet.

create_google_ads_linkLink Google Ads account

Link Google Ads account

No parameter schema in public metadata yet.

get_measurement_protocol_secretGet/create Measurement Protocol secret

Get/create Measurement Protocol secret

No parameter schema in public metadata yet.

run_reportRun report with dimensions, metrics, dates, filters

Run report with dimensions, metrics, dates, filters

No parameter schema in public metadata yet.

run_realtime_reportReal-time active users and events

Real-time active users and events

No parameter schema in public metadata yet.

get_metadataList available dimensions and metrics

List available dimensions and metrics

No parameter schema in public metadata yet.

Sponsors

Configuration

GA_CREDENTIALS

Google Service Account JSON key content (copy-paste the entire JSON)

GA_CREDENTIALS_PATHdefault: ~/.google-analytics-mcp/credentials.json

Alternative: path to the Service Account JSON key file

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)

  1. Google Cloud Console → IAM & Admin → Service Accounts

    • Create a service account (any name)
    • Click it → Keys → Add Key → JSON → Download
  2. Enable APIs in your GCP project:

  3. GA4 Admin → Property Access Management → Add the service account email (from the JSON) as Editor

  4. 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


View the full README on GitHub

Details

Repository
github.com/stucchi/mcp-google-analytics
Categories
Monitoring & Observability, Data & Analytics
Package
google-analytics-4-mcp
Transport
STDIO
Registry
MCP registry, active

More from stucchi

Related Monitoring & Observability MCP servers

View all
1jeanlopezxyz avatarMcp Prometheusjeanlopezxyz/mcp-prometheusA Model Context Protocol (MCP) server for Prometheus monitoring0stars
2builderio avatarAgent-Native Analyticsbuilderio/agent-nativeAgent-Native Amplitude/Mixpanel - connect data sources, prompt for charts7.6Kstars
3googleanalytics avatarAnalyticsgoogleanalytics/google-analytics-mcpProvides access to Google Analytics data and reports via an MCP API surface.2.1Kstars
4getsentry avatarSentrygetsentry/toolkitMCP server for Sentry - error monitoring, issue tracking, and debugging for AI assistants0stars
5pab1it0 avatarPrometheus MCP Serverpab1it0/prometheus-mcp-serverMCP server providing Prometheus metrics access and PromQL query execution for AI assistants522stars
6surendranb avatarGoogle Analytics Mcpsurendranb/google-analytics-mcpGA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.244stars