Connection guide
How to connect AskGA to your AI app, and what to check when something doesn't work.
Before you start
- An AskGA account with a verified email address
- A Google account that can view the GA4 properties you want to connect
- An AI app that can add a remote MCP server (connector). Support varies by app and plan, so check your app's help pages.
How to connect
- Sign up for AskGA and verify your email address using the link we send you.
- On the Connections page, add a Google account, then connect and turn on the GA4 properties you want to use.
- In your AI app's connector (MCP server) settings, add the address below.
- When prompted, sign in to AskGA and allow access. Then ask about your GA4 data in the chat.
Paste this address into your AI app's connector (MCP server) settings. You'll then be asked to sign in to AskGA and allow access.
For example, add it in Claude as a custom connector.
Tools
Every tool only reads GA4 data. Your AI picks the right tool for each question.
list_properties- Shows the GA4 properties you connected, with their time zone and currency.
get_metadata- Looks up the dimensions, metrics and custom definitions available in a property.
run_report- Runs GA4 reports with the date ranges, dimensions, metrics and filters you need. Relative dates are resolved to actual dates in the property's time zone.
run_realtime_report- Uses GA4 realtime reports to look up users and events active right now.
Example prompts
Try asking your AI:
- Which GA4 properties are connected to my AskGA account?
- Show sessions and active users by default channel group for the last 28 days.
- Compare the top 10 landing pages by sessions this month versus last month.
- How many users are on my site right now, by country?
Troubleshooting
When a tool call fails, AskGA returns an error code and your AI app shows it to you. Here's what to do for each code.
- Error code:
PROPERTY_NOT_CONNECTED - What to do:Connect and turn on that GA4 property on the Connections page.
- Error code:
ACCESS_INACTIVE - What to do:Check that the property is turned on in Connections, and that your subscription or free trial is active on the Billing page.
- Error code:
GOOGLE_REAUTH_REQUIRED - What to do:Reconnect that Google account on the Connections page.
- Error code:
GA_PERMISSION_DENIED - What to do:Make sure the Google account still has read access to the property in GA4, then reconnect it on the Connections page.
- Error code:
GA_QUOTA_EXHAUSTED - What to do:The GA4 API quota has run out. Try again later, or narrow the date range and dimensions.
- Error code:
INVALID_ARGUMENT - What to do:Ask your AI to check the dimension and metric names first, then run the query again.
- Error code:
UPSTREAM_UNAVAILABLE - What to do:Google Analytics didn't respond in time. Please try again shortly.
Keep getting asked to sign in, or lost the connection?
First make sure your email address is verified. If it still happens, disconnect the app under "Connected AI apps" on the Connections page, then add the connector again in your AI app.
How we handle your data
- We ask Google only for read-only GA4 access (analytics.readonly). AskGA never changes your GA4 settings or data.
- We fetch the reports your AI asks for and pass them on. We do not store what you look up or the results.
- Google connection credentials are stored encrypted. When you disconnect or delete your account, we ask Google to revoke access and then delete them.
- You can revoke an AI app's access at any time on the Connections page.
Support
If you can't connect or have questions, email us at support@askga.app.