MCP Google Analytics

GA4 MCP that reads AND writes: reports, funnels, audits, and server-side events.

Connector by leonardosepulvedat · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2

Install

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

npx agentmarket install connector/leonardosepulvedat-mcp-google-analytics

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

GA4 MCP that reads AND writes: reports, funnels, audits, and server-side events. 26 tools.

Reviews

Write a review

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 · 9 write · 0 delete
Secrets: 2 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Node.js package

Tools by what they do 26

Read from the source code; the running server may list different tools.

Read 17 · Look things up without changing anything.

ga_batch_run_reports
ga_check_compatibility
ga_get_account_summaries
ga_get_metadata
ga_get_property
ga_list_accounts
ga_list_custom_dimensions
ga_list_custom_metrics
ga_list_data_streams
ga_list_google_ads_links
ga_list_key_events
ga_list_properties

Show 5 more tools

ga_run_funnel_report
ga_run_pivot_report
ga_run_realtime_report
ga_run_report
ga_validate_event

Write 9 · Create, change, send or run things.

ga_send_add_to_cart
ga_send_begin_checkout
ga_send_event
ga_send_login
ga_send_pageview
ga_send_purchase
ga_send_refund
ga_send_signup
ga_send_view_item

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

GA_API_SECRET
GA_SERVICE_ACCOUNT_JSON

Other settings (environment variables or headers).

GA_MEASUREMENT_ID
GA_PROPERTY_ID

Tools (26)

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

ga_batch_run_reportsread-only
Run 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_check_compatibilityread-only
Check 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_get_account_summariesread-only
Get 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_get_metadataread-only
Get 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_get_propertyread-only
Get details about a GA4 property (the configured one, or any accessible property via propertyId).
ga_list_accountsread-only
List all Google Analytics accounts accessible to the service account. Use this to find account IDs for listing properties.
ga_list_custom_dimensionsread-only
List 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_metricsread-only
List all custom metrics defined for the configured GA4 property. Use this to discover custom metric API names for reports.
ga_list_data_streamsread-only
List data streams for the configured GA4 property. Use this to find measurement IDs for Measurement Protocol.
ga_list_google_ads_linksread-only
List Google Ads accounts linked to a GA4 property.
ga_list_key_eventsread-only
List 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_propertiesread-only
List Google Analytics properties. Optionally filter by account ID. Without an account ID, properties from all accessible accounts are aggregated.
ga_run_funnel_reportread-only
Run 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_run_pivot_reportread-only
Run 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_realtime_reportread-only
Get 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

Show 11 more tools

ga_run_reportread-only
Run 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_send_add_to_cart
Send an add to cart event to Google Analytics. Ecommerce event for tracking when items are added to shopping cart.
ga_send_begin_checkout
Send a begin checkout event to Google Analytics. Ecommerce event for tracking when users start the checkout process.
ga_send_event
Send 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_send_login
Send a login event to Google Analytics. Standard event for tracking user logins with authentication method.
ga_send_pageview
Send a page view event to Google Analytics. Standard event for tracking page/screen views. Automatically uses 'page_view' event name.
ga_send_purchase
Send an ecommerce purchase event to Google Analytics. Standard event for tracking completed purchases with transaction details and items.
ga_send_refund
Send 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.
ga_send_signup
Send a sign-up event to Google Analytics. Standard event for tracking new user registrations.
ga_send_view_item
Send 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_validate_eventread-only
Validate 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.

Signals

Stars: 2
Forks: 0
Open issues: 0
Last commit: Aug 21, 2026 (2 months ago)
Last release: Aug 21, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.leonardosepulvedat/mcp-google-analytics
Version: 1.3.0
Auth: API key
Packages: npm mcp-google-analytics
License: MIT
Repository: github.com/leonardosepulvedat/mcp-google-analytics
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql