What you can read and change in GA4
| Area | Read | Change |
|---|---|---|
| Reports | runReport with paging and caching; batch, pivot, funnel and realtime reports; quota snapshot | n/a |
| Metadata | Dimensions and metrics, compatibility checks before a report | n/a |
| Large jobs | Async report tasks and their results | Create report tasks |
| Audiences | Audience exports and their rows | Create audience exports |
| Key events | List and get key events | Create, update or delete, for example marking generate_lead as a key event |
| Custom definitions | Custom dimensions and metrics | Create, update or archive |
| Links and streams | Google Ads links, data streams | Create, update or delete |
Whathead vs Google's official Analytics MCP
| googleanalytics/google-analytics-mcp | Whathead | |
|---|---|---|
| Hosting | You run it with pipx or Docker, or deploy it to Cloud Run | Hosted at www.whathead.com/mcp |
| Reads | 10 tools: account summaries, property details, reports, funnels, realtime, key events | Reports, funnels, realtime, pivots, metadata, async tasks, audience exports |
| Writes | 3 opt-in tools with --allow-write: annotations, custom dimensions, key events | Key events, custom dimensions and metrics, Ads links, data streams |
| Price | Free; you pay for hosting | From $39/month |
| Other data | GA4 only | Search Console and 12 ad platforms in the same chat |
When Google's server is enough
If you only need GA4 reports and are comfortable running a server, Google's free open-source one is a good choice, and it can create property annotations, which Whathead cannot. Whathead fits when you want a hosted server, more Admin API coverage, or GA4 next to Meta, TikTok and Search Console in one conversation, for example to compare ad-platform conversions with GA4 key events.
- GA4 changes need a connection that granted the analytics.edit scope. Connections made before Whathead added Admin writes must reconnect once.
- Custom dimensions and metrics can only be archived, not deleted, and they are not retroactive.
- Audience exports can include user-level data, so ask for summaries rather than raw rows.
Set up the GA4 MCP
Connect GA4 in Whathead
In Integrations, sign in with Google, then sync properties so the assistant can see them.
Add Whathead to your assistant
Claude: Settings, Connectors, custom connector, https://www.whathead.com/mcp. ChatGPT: a developer-mode connector with that URL. Cursor: the URL plus a bearer token minted in Whathead.
Run a test report
Ask the assistant to list your GA4 properties, then run a 7-day sessions report on one before any Admin change.
GA4 prompts to try
Show sessions, engaged sessions and key events by source and medium for the last 28 days.
Build a funnel from landing page to add_to_cart to purchase for last month.
How many users are on the site right now, and on which pages?
Compare GA4 purchases with Meta-reported purchases by day for the last 14 days.
Mark generate_lead as a key event counted once per event. Show the preview first.
Register lead_type and form_id as event-scoped custom dimensions.
List the Google Ads accounts linked to this property.
Check whether itemCategory and sessionSource can be used in the same report.
Safety and plan limits
Admin changes default to dry_run: true and need the write:exports scope, so a read-only connector cannot change property setup. Report calls never modify data.
GA4 sits in the same monthly allowance as your ad platforms: MCP Actions ($39) with 1,500 reads and 100 writes, Operator Bundle ($65) with 4,000 and 250, Agency ($249) with 15,000 and 750. All plans start with a 14-day trial.
Frequently asked questions
Is there an official Google Analytics MCP?
Yes. Google publishes googleanalytics/google-analytics-mcp, an open-source server you host. Its write tools are off unless you pass --allow-write.
Is a GA4 MCP the same as a Google Analytics MCP?
Yes. Universal Analytics was retired, so both terms refer to Google Analytics 4 and its Data and Admin APIs.
Can it change GA4 settings?
Yes, for key events, custom dimensions and metrics, Google Ads links and data streams. Other settings, such as data retention or filters, are changed in the GA4 interface.
Why does a GA4 change return a reconnect error?
Your GA4 connection only has read access. Reconnect GA4 in Whathead once to grant the analytics.edit scope, then retry.
Run it from one workspace
Every plan starts with a 14-day free trial. Only successful live work is metered.
Sources
- googleanalytics/google-analytics-mcp on GitHub (github.com)