We have amended our Terms of Service and Privacy Policy (effective 2026-12-22). Terms of ServicePrivacy Policy

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

  1. Sign up for AskGA and verify your email address using the link we send you.
  2. On the Connections page, add a Google account, then connect and turn on the GA4 properties you want to use.
  3. In your AI app's connector (MCP server) settings, add the address below.
  4. 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.
Read the full Privacy Policy

Support

If you can't connect or have questions, email us at support@askga.app.

AskGA

Ask about your GA4 data in the AI you already use.

RED SUB Inc. ((주)레드서브) | CEO: Young Jun Kwon | Business Registration: 679-87-00603

Address: 101-411, 4F, 195 Baengma-ro, Ilsandong-gu, Goyang-si, Gyeonggi-do, Republic of Korea

Telecom Sales License: 제2025-고양일산동-1944호

Contact: 070-7954-6675 (No phone support) | support@askga.app

Hosting provider: Google Cloud Korea LLC

© 2026 AskGA. All rights reserved.