All servers / Analytics / Google Analytics MCP server
Google Analytics MCP server
GA4 MCP server that reads AND writes: run reports and funnels (Data API), audit your setup (custom dimensions, key events, compatibility checks), and send event
Tested by ConnectATDScore 84 out of 100. Tested 2026-11-19 on package version 1.3.1. Package: mcp-google-analytics · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 18 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 8 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (3.8 seconds including download)
- Tools offered: 26
- Last published: 2026-08-21
- Weekly downloads (npm): 687
- License: MIT · Direct dependencies: 4
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
ga_run_report9 of 9 parameters describedRun a custom Google Analytics report with dimensions and metrics. ⚠️ TOKEN OPTIMIZATION: Use 'limit' to control result size (default: 10). This tool can consume significant tokens with large datasets. Common dimensions: date, city, country, deviceCategory, browser, pagePath, eventName Common metrics: activeUsers, sessions, screenPageViews, conversions, totalRevenue
ga_run_realtime_report4 of 4 parameters describedGet real-time Google Analytics data (last 30 minutes). ⚠️ TOKEN OPTIMIZATION: Use 'limit' to control result size (default: 10). Common dimensions: city, country, deviceCategory, unifiedScreenName Common metrics: activeUsers, screenPageViews, conversions
ga_get_metadata1 of 1 parameter describedGet available dimensions and metrics metadata for your GA4 property. ⚠️ TOKEN OPTIMIZATION: This returns ALL available dimensions and metrics. Response can be large (~500+ items). Use sparingly and cache results when possible.
ga_list_accountsno parametersList all Google Analytics accounts accessible to the service account. Use this to find account IDs for listing properties.
ga_list_properties1 of 1 parameter describedList Google Analytics properties. Optionally filter by account ID. Without an account ID, properties from all accessible accounts are aggregated.
ga_get_property1 of 1 parameter describedGet details about a GA4 property (the configured one, or any accessible property via propertyId).
ga_list_data_streams1 of 1 parameter describedList data streams for the configured GA4 property. Use this to find measurement IDs for Measurement Protocol.
ga_run_pivot_report2 of 5 parameters describedRun a pivot table report with row and column dimensions. ⚠️ TOKEN OPTIMIZATION: Pivot reports can be VERY large. Limit dimensions and use small date ranges. Recommended for analysis, not raw data extraction.
ga_run_funnel_report3 of 5 parameters describedRun a funnel analysis report to track user progression through steps (Data API v1alpha). Each step matches an event: set 'eventName' per step (defaults to the step name). For advanced matching, pass a full 'filterExpression' instead.
ga_batch_run_reports2 of 2 parameters describedRun multiple reports in a single request. ⚠️ TOKEN OPTIMIZATION: Can return LARGE amounts of data. Limit to 2-5 reports per batch. Each report should have small limits.
ga_get_account_summariesno parametersGet a compact overview of all accessible GA accounts and their properties in a single call. The fastest way to discover account IDs, property IDs, and property names.
ga_list_custom_dimensions1 of 1 parameter describedList all custom dimensions defined for the configured GA4 property. Use this to discover custom dimension API names (e.g., "customEvent:plan_type") for reports.
ga_list_custom_metrics1 of 1 parameter describedList all custom metrics defined for the configured GA4 property. Use this to discover custom metric API names for reports.
ga_list_key_events1 of 1 parameter describedList the key events (conversions) configured for the GA4 property. Useful to know which event names count as conversions before building reports or sending events.
ga_list_google_ads_links1 of 1 parameter describedList Google Ads accounts linked to a GA4 property.
ga_check_compatibility4 of 4 parameters describedCheck whether a combination of dimensions and metrics is valid for this property BEFORE running a report. Avoids wasted report requests and token-heavy error loops. Also lists which other fields remain compatible with the given combination.
ga_send_event4 of 4 parameters describedSend a custom event to Google Analytics via Measurement Protocol. Use this for tracking custom user actions, conversions, or any GA4 event. Events are processed asynchronously and appear in reports within minutes. Common events: click, form_submit, video_play, file_download, custom_conversion
ga_validate_event1 of 4 parameters describedValidate an event before sending it to Google Analytics. Uses GA4's debug endpoint to check for errors without recording the event. Returns validation messages and errors if any.
ga_send_pageview6 of 6 parameters describedSend a page view event to Google Analytics. Standard event for tracking page/screen views. Automatically uses 'page_view' event name.
ga_send_purchase9 of 11 parameters describedSend an ecommerce purchase event to Google Analytics. Standard event for tracking completed purchases with transaction details and items.
ga_send_login3 of 4 parameters describedSend a login event to Google Analytics. Standard event for tracking user logins with authentication method.
ga_send_signup3 of 4 parameters describedSend a sign-up event to Google Analytics. Standard event for tracking new user registrations.
ga_send_add_to_cart4 of 6 parameters describedSend an add to cart event to Google Analytics. Ecommerce event for tracking when items are added to shopping cart.
ga_send_begin_checkout5 of 7 parameters describedSend a begin checkout event to Google Analytics. Ecommerce event for tracking when users start the checkout process.
ga_send_view_item4 of 6 parameters describedSend a view item event to Google Analytics. Ecommerce event for tracking product/item detail views. Completes the standard funnel: view_item → add_to_cart → begin_checkout → purchase.
ga_send_refund5 of 7 parameters describedSend a refund event to Google Analytics. Ecommerce event for full or partial refunds. Omit 'items' for a full refund; include them (with quantities) for a partial refund. Use the same transaction_id as the original purchase.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.