Connect a module

Google Analytics 4

ShopMCP uses standard Google OAuth — every workspace authorizes its own Google account. We never use a service account or domain delegation.

1. Start the Google sign-in

Open Settings → Integrations and click Connect on the GA4 card. You'll be redirected to a Google consent screen requesting one scope:

https://www.googleapis.com/auth/analytics.readonly — read access to GA4 reports and metadata

Approve, and Google sends you back to ShopMCP with a refresh token we encrypt and store per-workspace.

2. Pick a GA4 property

After OAuth, ShopMCP fetches every GA4 property your Google account can see and asks you to pick one. The property ID gets attached to the connection so every tool call queries the right data.

Multi-property support

Need more than one GA4 property in the same workspace? Click Connect again — each run creates a new connection row. Tools that need disambiguation (e.g. cross-property reports) accept a property_id argument.

3. Confirm and query

The connection card now shows Connected, the Google account email, and the GA4 property name. Try a question in your chat client:

How much traffic did we get last week, by channel?
Top 10 landing pages by sessions in March
Compare conversion rate this week vs last week

Required GA4 access level

The Google account you authorize needs at least Viewer on the GA4 property. Marketer and Editor work too, but Viewer is enough for everything ShopMCP exposes — we never write to GA4.

Troubleshooting

"No GA4 properties found" — the Google account you used doesn't have access to any GA4 property. Either ask a property admin to invite you, or sign out and re-run the connect flow with a different Google account.
Reports return empty for old date ranges — GA4 only stores 14 months by default. Check your property's data retention setting in Google Analytics admin.
"Permission denied" on a specific report — a few advanced reports need Editor on the GA4 property. The error envelope tells you which tool and which scope.