Google Analytics 4 MCP connector

What agents can do

• Custom reports: get_report runs runReport with any dimensions and metrics, date ranges, filters, ordering, comparisons and cohorts, and pages through up to 1,000,000 rows.
• Predefined reports: traffic sources, pages, events, ecommerce, geo, tech and user demographics.
• Property configuration: read and update the property, data retention and enhanced measurement settings, and manage data streams.
• Key events, custom dimensions and custom metrics: list, create, update, and delete or archive.
• Audiences and channel groups: list, create, update and archive audiences, and manage custom channel groups.
• Links and Measurement Protocol: manage Google Ads links, BigQuery links and Measurement Protocol secrets.

Before you connect

• A Google login with access to the GA4 property. Configuration changes also need edit access to the property in Google Analytics.
• Universal Analytics properties are not supported.

Connect Google Analytics

1. In the InsightfulPipe app, open Connectors, choose Google Analytics and click Connect.
2. Choose Read Only or Read + Write.
3. Sign in with Google and approve access.
4. Select one or more GA4 properties. Each property becomes its own connection.
5. Add the MCP server to Claude, ChatGPT or another client, then click Authorize access.

Permissions and safety

• Read Only grants analytics.readonly. Read + Write adds analytics.edit for Admin API changes.
• Admin actions are locked to the connected property. The exception is create_property, which creates a property under any account your Google login can edit; the new property is not connected automatically.
• list_accounts and the two Measurement Protocol secret reads count as write actions: the first lists every account your Google login administers, and the others return a reusable secret.
• Twelve actions are destructive and off by default: delete_property (moves the property to the GA4 trash), delete_data_stream, delete_key_event, delete_channel_group, delete_google_ads_link, delete_bigquery_link, delete_measurement_protocol_secret, archive_audience, archive_custom_dimension, archive_custom_metric, update_data_retention_settings and acknowledge_user_data_collection.

Limits

• Reports use runReport only. There are no realtime, pivot or batch reports.
• Audiences, channel groups, BigQuery links and enhanced measurement use the Admin API v1alpha, which Google can change without notice.
• Audience updates cover the name, description and event trigger only, and membership duration must be 1 to 540 days.
• Admin list actions return 50 records per page.
• create_bigquery_link also needs BigQuery permissions in Google Cloud.

Example prompts

• "Using Google Analytics, show sessions, engaged sessions and key events by default channel group for the last 28 days."
• "Which landing pages had the highest bounce rate last week with at least 500 sessions?"
• "List the custom dimensions on this property and create an event-scoped dimension for plan_type."
• "Compare purchase revenue by device category this month versus last month."

Troubleshooting

• "This account is connected read-only, so this action cannot be enabled for it." Reconnect the property with Read + Write to change configuration.
• "This action is disabled for this connected account." An owner, admin or operator must enable it in Configure actions for this account.
• Recent days look low: compare complete days and extend the date range before drawing conclusions.