Google Analytics 4 / API Reference
ga4_user_retention
GA4 analytics tool. Get GA4 user retention metrics: new vs returning users, engagement rate, sessions per user. Args: property_id: GA4 property ID. Leave blank to use the default property. start_date: Start date YYYY-MM-DD. Defaults to 90 days ago. end_date: End date YYYY-MM-DD. Defaults to today.
This is a read-only tool: it returns user retention for your Google Analytics 4 account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
User retention in my Google Analytics 4 account.
It takes 0 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
property_id | string | No | Property Id |
start_date | string | No | Start Date |
end_date | string | No | End Date |
Related Google Analytics 4 tools
ga4_user_journeyga4_acquisition_channelsga4_attribution_pathsga4_audiencesga4_audit_property_settingsga4_available_metrics
Before you can call it
This tool needs a connected Google Analytics 4 account. The Google Analytics 4 connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: