Google Analytics 4 MCP

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/scalably-io-ga4-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

17 read · 0 write · 0 deleteRead-only

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Python package

Tools (17)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• ga4_batch_run_reportsRun batch GA4 reportsread-only

  Run up to 5 GA4 reports in a single round-trip. requests: list of run_report-shaped dicts. Same top-level parameters as ga4_run_report (minus property_id, inferred from the batch). Each entry accepts: dimensions, metrics, date_ranges, dimension_filter, metric_filter, order_bys, metric_aggregations, limit, offset, keep_empty_rows, currency_code. Useful when the agent needs paired views (e.g. landing pages + referrers for the same window) and wants them atomically + under one quota call.

• ga4_check_compatibilityCheck dimension metric compatibilityread-only

  Validate whether a dim/metric combo can be queried together. Cheap pre-flight. compatibility_filter: 'COMPATIBLE' (default, returns only fields that work with the provided selection) or 'INCOMPATIBLE' (returns only fields that would conflict). Use before run_report when composing exploratory queries, cheaper than catching a GoogleAdsException after a big failed report.

• ga4_get_metadataGet GA4 dimension metric catalogread-only

  Fetch the full GA4 dimension + metric catalog for a property. If property_id is omitted, returns the universal catalog (excludes property-specific custom fields). Pass a property_id to include custom dimensions and metrics like 'customEvent:foo' and 'customUser:signup_plan'. Response: {"dimensions": [...], "metrics": [...]}. Each entry has api_name, ui_name, description, category, custom_definition. Call this before run_report when the agent is uncertain about field names: GA4's catalog is large and custom fields require the property to resolve.

• ga4_get_property_detailsGet GA4 property detailsread-only

  Full metadata for a single GA4 property. Returns display_name, property_type, parent account, time_zone, currency_code, industry_category, service_level, delete_time, expire_time, account reference, create_time, update_time. property_id: numeric (e.g. "123456789") or resource (e.g. "properties/123456789").

• ga4_list_account_summariesList GA4 account summariesread-only

  List every GA4 account and its child properties accessible to this service account. CALL THIS FIRST to discover which property_id to pass into other tools. The SA only sees accounts/properties where its email has been explicitly added as a user. Response: {"accounts": [{account, display_name, property_summaries: [...], ...}]}. Each property_summary has property, display_name, property_type, parent.

• ga4_list_audiencesList GA4 audiencesread-only

  List audiences defined on a GA4 property. Each audience has name, display_name, description, membership_duration_days, ads_personalization_enabled, event_trigger, exclusion_duration_mode, filter_clauses. Reference audienceId as a dimension in run_report for audience-based breakdowns. NOTE: Uses Admin v1alpha since audiences are still alpha in April 2026.

• ga4_list_custom_dimensionsList custom dimensionsread-only

  List custom dimensions configured on a GA4 property. Each entry contains the parameter_name (how you query it, use prefix 'customEvent:' or 'customUser:' when passing to get_metadata / run_report), display_name, scope (EVENT|USER|ITEM), and description. Essential grounding before running reports that reference custom fields.

• ga4_list_custom_metricsList custom metricsread-only

  List custom metrics configured on a GA4 property. Each entry: parameter_name, display_name, measurement_unit, scope, restricted_metric_type.

• ga4_list_data_streamsList GA4 data streamsread-only

  List all data streams (web, iOS, Android) on a GA4 property. Useful for finding the Measurement ID (web), firebase_app_id (mobile), or the hostname of a web stream. Each stream has its creation/update timestamps.

• ga4_list_google_ads_linksList Google Ads linksread-only

  List Google Ads links attached to a GA4 property. Returns customer_id (the Ads account), can_manage_clients, ads_personalization_enabled, and creator_email. Useful to confirm Ads ↔ GA4 cross-reporting availability before querying Ads-related dimensions like sessionGoogleAdsCampaignId.

• ga4_list_key_eventsList GA4 key eventsread-only

  List key events (formerly conversions) on a GA4 property. These are the events the client has marked as conversion-worthy. Query conversion metrics via `conversions` dimension or direct metric names.

• ga4_list_property_annotationsList property annotationsread-only

  List reporting annotations on a GA4 property. Annotations are markers (user-added or Google-system) flagging important events on a timeline: product launches, outages, marketing pushes, so downstream analysis can correlate metric swings with known events. Each annotation has: name, title, description, annotation_date, annotation_date_range, color, creator_email, system_generated. NOTE: Uses Admin v1alpha since annotations are still alpha in April 2026.

• ga4_run_access_reportRun GA4 access reportread-only

  Audit log of who-read-what on a GA4 property (last 12 months). dimensions (common): userEmail, accessedPropertyName. metrics: accessCount. date_ranges: list of {start_date, end_date} (YYYY-MM-DD or relative). Defaults to last 7d. Use cases: identify usage of GA4 data by staff, confirm SA activity, compliance audits.

• ga4_run_funnel_reportRun GA4 funnel reportread-only

  Run a GA4 funnel report. v1alpha, API surface may change. funnel: { is_open_funnel: bool, steps: [ { name: str, is_directly_followed_by: bool, filter_expression: FunnelFilterExpression, within_duration_from_prior_step: {seconds: int}, }, ... ] } funnel_breakdown: {dimension_name, limit}, optional per-step breakdown. funnel_next_action: {dimension_name, limit}, optional "what came after". Use for drop-off analysis across a sequence of events. Behind an alpha flag because Google can change the shape, check the Feb 2026 release notes if this fails with a va…

• ga4_run_pivot_reportRun GA4 pivot reportread-only

  Run a GA4 pivot report. pivots: list of pivot specs, each with: - field_names: list of dimension names to pivot on - limit: max rows per pivot - offset: pagination offset - order_bys: list of OrderBy dicts (same shape as run_report's order_bys) - metric_aggregations: list of TOTAL|MINIMUM|MAXIMUM|COUNT Use when you want a 2D view: e.g. rows=date, columns=device, values=sessions.

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

103

Last commit

Sep 9, 2026 (1 month ago)

Last release

Sep 9, 2026 (1 month ago)

Last package publish

Sep 9, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.scalably/ga4-mcp

Version

1.0.1

Auth

No auth

Packages

pypi scalably-ga4-mcpmcpb https://github.com/scalably-io/ga4-mcp/releases/download/v1.0.1/ga4-mcp.mcpb

License

MIT

Repository

github.com/scalably-io/ga4-mcp

Website

scalably.io/mcp/ga4-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql