Google Analytics 4 MCP server

Read from the package source without running it. The installed server may list more.

• ga4_batch_run_pivot_reportswrite action

  Run 1-5 independent read-only GA4 pivot reports for the same property in one official Data API batch request.

• ga4_batch_run_reportswrite action

  Run 1-5 independent read-only GA4 Core reports for the same property in one official Data API batch request.

• ga4_check_compatibility

  Ask the official GA4 Data API which dimensions and metrics are compatible with a proposed Core report selection.

• ga4_get_audience_diagnostics

  Read-only audience diagnostics from Admin API audiences, Data API recurring audience lists, and observed audienceName report fallback.

• ga4_get_audience_export_diagnostics

  Read-only Audience Export diagnostics. Lists existing audience exports, state counts, and optionally samples rows from an existing export.

• ga4_get_bigquery_export_diagnostics

  Detect GA4 BigQuery export links and diagnose export modes, stream coverage, excluded events, and dataset location.

• ga4_get_channel_groups

  List custom channel groups defined for a GA4 property.

• ga4_get_custom_definitions

  List custom dimensions and custom metrics exposed by GA4 Data API metadata. Read-only fallback for custom definition inventory.

• ga4_get_ecommerce_diagnostics

  Read-only ecommerce coverage diagnostics for core ecommerce events, revenue metrics, and item-level reporting over a date range.

• ga4_get_event_parameters

  Best-effort event parameter inventory from GA4 metadata plus event reports. Documents Data API limitations for raw parameters.

• ga4_get_key_events

  Inventory GA4 key events/conversions using metadata-aware Data API reports. Returns best-effort event names and counts.

• ga4_get_metadata

  Get the complete list of dimensions and metrics available for a specific GA4 property. Useful for discovering custom dimensions/metrics.

• ga4_get_property_configuration

  Read GA4 property details plus selected singleton Admin settings (attribution, retention, Google Signals, reporting identity, or user-provided-data settings).

• ga4_get_property_quotas_snapshot

  Read the current GA4 Data API property quota snapshot from the official v1alpha endpoint. This does not run a report, but Google still charges one property-quota token to the category with the most remaining quota.

• ga4_get_server_side_tagging_diagnostics

  Best-effort read-only server-side tagging diagnostics from data streams, Measurement Protocol secrets, event rules, and stream settings.

• ga4_health_check

  Read-only GA4 health check. Verifies configured credentials, accessible properties, and metadata/property access without exposing OAuth tokens.

• ga4_list_accounts

  List raw GA4 Analytics Admin accounts accessible to the authenticated user (read-only, auto-paginated).

• ga4_list_admin_resources

  List an allowlisted GA4 Admin collection in read-only mode: streams, custom definitions, key events, audiences, product links, annotations, channel groups, expanded datasets, subproperty/rollup configuration, and access bindings.

• ga4_list_audience_exports

  List existing GA4 Audience Export snapshots and Recurring Audience Lists without creating new exports.

• ga4_list_properties

  List all GA4 properties accessible with the current credentials. Returns property ID, display name, timezone, and currency.

• ga4_query_audience_export

  Query rows from an existing GA4 Audience Export. User/device identifiers are redacted by default; include them only through explicit opt-in.

• ga4_run_advanced_funnel_reportwrite action

  Run the GA4 Data API v1alpha runFunnelReport endpoint with optional breakdown/next-action, falling back to read-only step counts if unavailable.

• ga4_run_funnel_recipewrite action

  Run a read-only configurable funnel recipe using one GA4 report per eventName/pagePath step and return simple step counts.

• ga4_run_pivot_reportwrite action

  Run a read-only GA4 Data API pivot report with native filters, ordering, quota state, multiple date ranges, and up to 250,000 pivot cells. Every pivot requires an explicit limit.

• ga4_run_realtime_reportwrite action

  Run a read-only GA4 Data API realtime report. Realtime supports only a limited subset of dimensions and metrics.

• ga4_run_reportwrite action

  Run a GA4 analytics report with intelligent query planning. Supports 52 metrics, 63 dimensions, auto-pagination. Use ga4://metrics and ga4://dimensions resources for available fields. Max 9 dimensions + 10 metrics per request.

• ga4_validate_query

  Validate a metric/dimension combination BEFORE executing. Checks max limits (9 dims, 10 metrics), ecommerce rules, and dimension compatibility.

• Code scan7 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 4 days ago15/15
• Maintainer identitynamespace and repository owner differ; website matches verified namespace6/10

Safety score

80/100

higher than 60% of 48,255 servers

Tools

27

the typical server has 7

Tools that change things

26%

typical: 0%. Fewer write tools means less an agent can break

Downloads a week

530

more than 89% of 12,191 servers with a package

Grade history

• 2026-10-30restoreC → Bscore 80

Google Analytics 4: common questions

Is Google Analytics 4 MCP server safe?

Mostly: it is graded B (80/100). Read the Google Analytics 4 safety report

How do I install Google Analytics 4?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Google Analytics 4 need an API key?

Yes. The registry entry asks for GA4_CLIENT_SECRET, GA4_REFRESH_TOKEN.

Is Google Analytics 4 maintained?

The last commit was 9 days ago (2026-10-26). The latest release is v2.1.1.

How does Google Analytics 4 compare with other MCP servers?

safety score 80/100 (higher than 60% of 48,255 servers); tools 27 (the typical server has 7); tools that change things 26% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.