# Google Analytics 4 setup

> Connect Google Analytics 4 to Claude, ChatGPT, Codex or any MCP client, what to ask it once it is connected, and the 27 tools behind the answers.

[Guides](https://www.getmcpads.com/guides)

## For you

Reports, realtime, funnels, key events, ecommerce and server-side tagging diagnostics.

## Connect it

1. Open the dashboard and choose this platform.
2. Approve the consent screen. The gateway stores an encrypted refresh token, never a password.
3. Tick the accounts to expose. Nothing is readable until you do.
4. Paste the endpoint into your assistant, or use the shared one for every platform at once.

Google Analytics 4 on its own endpoint

```text
https://mcp.getmcpads.com/ga4/mcp
```

## What to ask

```text
Sessions and conversions by channel group for the last 28 days.
Did the checkout funnel move after Tuesday's release?
What is happening on the site right now?
Which events are key events, and what custom definitions exist?
Is this dimension and metric combination even legal?
```

## What answers each one

| Question | Tools |
| --- | --- |
| Sessions and conversions by channel group for the last 28 days. | [`ga4_run_report`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_report), [`ga4_get_channel_groups`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_channel_groups) |
| Did the checkout funnel move after Tuesday's release? | [`ga4_run_funnel_recipe`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_funnel_recipe), [`ga4_run_advanced_funnel_report`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_advanced_funnel_report) |
| What is happening on the site right now? | [`ga4_run_realtime_report`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_run_realtime_report) |
| Which events are key events, and what custom definitions exist? | [`ga4_get_key_events`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_key_events), [`ga4_get_custom_definitions`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_get_custom_definitions) |
| Is this dimension and metric combination even legal? | [`ga4_check_compatibility`](https://www.getmcpads.com/docs/sources/ga4/tools/ga4_check_compatibility) |

## What it can change

Google Analytics 4 is read only here. The gateway exposes no tool that changes anything on it.

- [Google Analytics 4 reference](https://www.getmcpads.com/docs/sources/ga4): All 27 tools, with their parameters.
- [Metrics](https://www.getmcpads.com/docs/sources/ga4/metrics): 51 metrics you can request.
- [Dimensions](https://www.getmcpads.com/docs/sources/ga4/dimensions): 62 ways to break a report down.
- [Skills](https://www.getmcpads.com/skills): 39 operating procedures use this source.

## For your agent

|  |  |
| --- | --- |
| Platform id | `ga4` |
| Tool prefix | `ga4_` |
| Account parameter | `propertyId` |
| Dedicated endpoint | https://mcp.getmcpads.com/ga4/mcp |
| Tools | 27, 0 of which write |
| Announced by default | `ga4_get_key_events`, `ga4_health_check`, `ga4_list_properties`, `ga4_run_realtime_report`, `ga4_run_report` |
| Metrics | 51, see /docs/sources/ga4/metrics |
| Dimensions | 62, see /docs/sources/ga4/dimensions |

## Scope requested from the platform

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `https://www.googleapis.com/auth/analytics.readonly` | Read GA4 reports, metadata and property configuration. Cannot modify anything. | No |

## Reaching a tool that is not announced

```text
search_tools({ task: "..." })      find it
describe_tool({ name: "..." })     read its schema
run_tool({ name, args })           execute, with the same checks
```

## What will refuse you

- An account not ticked by the owner. Call `list_accounts` and use a `propertyId` from it.
- Any write. Google Analytics 4 is read only here.
- A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it.

## Questions this source answers

| Question | Tools, in order |
| --- | --- |
| Sessions and conversions by channel group for the last 28 days. | `ga4_run_report` then `ga4_get_channel_groups` |
| Did the checkout funnel move after Tuesday's release? | `ga4_run_funnel_recipe` then `ga4_run_advanced_funnel_report` |
| What is happening on the site right now? | `ga4_run_realtime_report` |
| Which events are key events, and what custom definitions exist? | `ga4_get_key_events` then `ga4_get_custom_definitions` |
| Is this dimension and metric combination even legal? | `ga4_check_compatibility` |

---

This page as HTML: https://www.getmcpads.com/guides/sources/ga4
Every page under /guides and /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.