Google Analytics 4 MCP Server

Explore traffic, conversions, funnels and property configuration through a read-only MCP server.

Local serverstdioApache-2.0

What is the Google Analytics 4 MCP Server?

Google Analytics is an MCP project maintained in the get-mcp-ads/google-analytics-mcp-server repository. The maintainer describes its purpose as “Explore traffic, conversions, funnels and property configuration through a read-only MCP server”. Read the project documentation for the complete scope.

Installation

The documented npm package is @getmcpads/google-analytics-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares GA4_CLIENT_ID, GA4_CLIENT_SECRET, GA4_REFRESH_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-09.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ga4_health_checkRead-only GA4 health check.
ga4_list_propertiesList all GA4 properties accessible with the current credentials.
ga4_run_reportRun a GA4 analytics report with intelligent query planning.
ga4_run_realtime_reportRun a read-only GA4 Data API realtime report.
ga4_get_metadataGet the complete list of dimensions and metrics available for a specific GA4 property.
ga4_get_custom_definitionsList custom dimensions and custom metrics exposed by GA4 Data API metadata.
ga4_get_key_eventsInventory GA4 key events/conversions using metadata-aware Data API reports.
ga4_get_ecommerce_diagnosticsRead-only ecommerce coverage diagnostics for core ecommerce events, revenue metrics, and item-level reporting over a date range.
ga4_get_event_parametersBest-effort event parameter inventory from GA4 metadata plus event reports.
ga4_run_funnel_recipeRun a read-only configurable funnel recipe using one GA4 report per eventName/pagePath step and return simple step counts.
ga4_get_audience_export_diagnosticsRead-only Audience Export diagnostics.
ga4_get_audience_diagnosticsRead-only audience diagnostics from Admin API audiences, Data API recurring audience lists, and observed audienceName report fallback.
ga4_get_bigquery_export_diagnosticsDetect GA4 BigQuery export links and diagnose export modes, stream coverage, excluded events, and dataset location.
ga4_get_server_side_tagging_diagnosticsBest-effort read-only server-side tagging diagnostics from data streams, Measurement Protocol secrets, event rules, and stream settings.
ga4_run_advanced_funnel_reportRun the GA4 Data API v1alpha runFunnelReport endpoint with optional breakdown/next-action, falling back to read-only step counts if unavailable.
ga4_get_channel_groupsList custom channel groups defined for a GA4 property.
ga4_validate_queryValidate a metric/dimension combination BEFORE executing.
ga4_run_pivot_reportRun a read-only GA4 Data API pivot report with native filters, ordering, quota state, multiple date ranges, and up to 250,000 pivot cells.
ga4_batch_run_reportsRun 1-5 independent read-only GA4 Core reports for the same property in one official Data API batch request.
ga4_batch_run_pivot_reportsRun 1-5 independent read-only GA4 pivot reports for the same property in one official Data API batch request.
ga4_check_compatibilityAsk the official GA4 Data API which dimensions and metrics are compatible with a proposed Core report selection.
ga4_get_property_quotas_snapshotRead the current GA4 Data API property quota snapshot from the official v1alpha endpoint.
ga4_list_accountsList raw GA4 Analytics Admin accounts accessible to the authenticated user (read-only, auto-paginated).
ga4_list_admin_resourcesList an allowlisted GA4 Admin collection in read-only mode: streams, custom definitions, key events, audiences, product links, annotations, channel groups…
ga4_get_property_configurationRead GA4 property details plus selected singleton Admin settings (attribution, retention, Google Signals, reporting identity, or user-provided-data settings).
ga4_list_audience_exportsList existing GA4 Audience Export snapshots and Recurring Audience Lists without creating new exports.
ga4_query_audience_exportQuery rows from an existing GA4 Audience Export.
URIContents

How to install the Google Analytics 4 MCP Server

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-analytics-mcp-server"
      ],
      "env": {
        "GA4_CLIENT_ID": "your-client-id",
        "GA4_CLIENT_SECRET": "YOUR_GA4_CLIENT_SECRET",
        "GA4_REFRESH_TOKEN": "YOUR_GA4_REFRESH_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GA4_CLIENT_IDDeclared in the maintainer’s client configuration.Yes
GA4_CLIENT_SECRETDeclared in the maintainer’s client configuration.Yes
GA4_REFRESH_TOKENDeclared in the maintainer’s client configuration.Yes