Google Analytics 4 MCP server

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

• ga_batch_run_reportswrite action

  Run multiple GA4 reports (max 5) in a single batch request. Each report shares the row-volume safety net of ga_run_report.

• ga_check_compatibility

  Check whether a set of dimensions and metrics can be used together in a GA4 report. Useful before running a complex report to avoid INCOMPATIBLE errors.

• ga_create_audience_exportwrite action

  Create an audience export — a server-side snapshot of the users in a GA4 audience for later retrieval. Charges audience-export quota tokens and takes seconds-to-minutes to become ACTIVE; poll with ga_get_audience_export, then page users with ga_query_audience_export. Does not modify property configuration.

• ga_create_report_taskwrite action

  Start an asynchronous report task for a large GA4 export. Unlike ga_run_report this has no synchronous timeout and no row-volume warning gate — the task materialises up to `limit` rows server-side. Poll ga_get_report_task until state is ACTIVE, then page rows with ga_query_report_task. Uses the v1alpha Data API; structure may evolve over time.

• ga_get_audience_export

  Get the configuration metadata and state of an audience export. Poll this after ga_create_audience_export until state is ACTIVE before querying rows.

• ga_get_custom_dimensions_and_metrics

  List all custom dimensions and custom metrics configured on a GA4 property.

• ga_get_data_retention_settings

  Get the configured event data retention settings for a GA4 property.

• ga_get_dimensions_by_category

  Get dimensions for a given category name (from ga_list_dimension_categories).

• ga_get_global_site_tag

  Get the gtag.js / global site tag snippet for the first web data stream on a GA4 property.

• ga_get_metadata

  Get the live GA4 metadata for the property, including all available dimensions and metrics. Use this when you need the raw schema; prefer ga_search_schema for keyword lookups.

• ga_get_metrics_by_category

  Get metrics for a given category name (from ga_list_metric_categories).

• ga_get_property_details

  Get details for a single GA4 property — display name, currency code, configured time zone, industry category, service level, and timestamps.

• ga_get_property_quotas_snapshot

  Return a fresh property quota snapshot using a lightweight GA4 report call. Use this to check remaining tokens / requests before kicking off a large batch.

• ga_get_property_schema

  Return the full GA4 property schema, including dimension count and metric count. Same data as ga_get_metadata with summary counts.

• ga_get_report_task

  Get the metadata and state of a report task. Poll this after ga_create_report_task until state is ACTIVE before querying rows. Uses the v1alpha Data API.

• ga_list_account_summaries

  List Google Analytics accounts and their property summaries available to the authenticated user. Use this first to discover available property IDs before calling other tools.

• ga_list_audience_exports

  List all audience exports for a GA4 property. Useful to find and reuse an existing export rather than creating a new one.

• ga_list_audiences

  List all audiences configured on a GA4 property, including membership duration, ads-personalization flag, and filter clauses. Uses the v1alpha Admin API (audiences are not yet promoted to v1beta); structure may evolve over time.

• ga_list_bigquery_links

  List all BigQuery export links configured on a GA4 property.

• ga_list_channel_groups

  List all channel groups configured on a GA4 property, including the grouping rules that define channels such as "Organic Social". Uses the v1alpha Admin API (channel groups are not yet promoted to v1beta); structure may evolve over time.

• ga_list_data_streams

  List all data streams (web, Android app, iOS app) on a GA4 property.

• ga_list_dimension_categories

  List available dimension categories for the property schema.

• ga_list_firebase_links

  List all Firebase project links configured on a GA4 property.

• ga_list_google_ads_links

  List all Google Ads links configured on a GA4 property.

• ga_list_key_events

  List all key events (formerly conversions) configured on a GA4 property.

• ga_list_metric_categories

  List available metric categories for the property schema.

• ga_list_properties

  List GA4 properties visible to the authenticated user, optionally filtered by account_id or property_id. Returns a flat list — easier to consume than ga_list_account_summaries when you just want property IDs.

• ga_query_audience_export

  Retrieve users from an ACTIVE audience export, with offset/limit pagination. Rows contain user-level identifiers (user IDs / device IDs) — treat them as privacy-sensitive. The export must be ACTIVE; poll ga_get_audience_export first.

• ga_query_report_task

  Retrieve rows from an ACTIVE report task with offset/limit pagination (up to 250,000 rows per page). The task must be ACTIVE; poll ga_get_report_task first. Uses the v1alpha Data API.

• ga_run_pivot_reportwrite action

  Run a GA4 pivot report. Pivots are useful for cross-tabulating dimensions (e.g. country x device).

• ga_run_realtime_reportwrite action

  Run a GA4 realtime report with configurable dimensions and metrics. Realtime data covers the last 30 minutes by default.

• ga_run_reportwrite action

  Run a GA4 report with configurable dimensions, metrics, date range, ordering, and safe dataset controls. Estimates row count first; returns a warning above row_warning_threshold (default 2500). Use ga_search_schema to discover dimension/metric apiNames.

• ga_search_change_history_events

  Search the change history (created/updated/deleted) for a GA4 property. Follows all result pages automatically, so large histories are returned in full. Uses the v1alpha admin API; structure may evolve over time.

• ga_search_schema

  Search dimensions and metrics by keyword across the live GA4 property schema. Use this to discover the exact apiName for a concept (e.g. "session", "revenue", "country").

• Code scan31 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 qualitylocal package, no credentials required12/15
• Maintenancelast push 0 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Safety score

94/100

higher than 96% of 48,114 servers

Tools

34

the typical server has 7

Tools that change things

18%

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

GitHub stars

14

more than 89% of 28,851 servers

Downloads a week

65

more than 40% of 15,093 servers with a package

Google Analytics 4: common questions

Is Google Analytics 4 MCP server safe?

Yes, by our scan: it is graded A (94/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?

No secret keys are declared. It reads 2 settings from the environment.

Is Google Analytics 4 maintained?

The last commit was 11 days ago (2026-11-04). The latest release is v0.2.1.

How does Google Analytics 4 compare with other MCP servers?

safety score 94/100 (higher than 96% of 48,114 servers); tools 34 (the typical server has 7); tools that change things 18% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.