Skip to main content

​
Google Analytics

In one line: Connect Google Analytics so your UnleashX agent can list your GA4 accounts and properties and run standard and realtime reports — all in plain language.

​
1. Overview

Google Analytics 4 (GA4) is Google’s web and app analytics platform. It organizes your data into accounts and properties, and reports on the traffic, engagement, and conversions those properties collect. Once connected to UnleashX, your agent can list the GA4 accounts and properties you can access, look up a property’s details, and run both standard analytics reports and realtime reports. It works against your live GA4 data using your own Google sign-in, so it respects your role and permissions. This connector is read-focused — it reads metrics rather than changing your analytics setup. Connecting Google Analytics to UnleashX turns your metrics into something you can ask about directly. Instead of building a report in the GA4 UI, you ask your agent for the numbers and it runs the report for you.

​
2. What you’ll need

  • A Google Analytics account with at least one GA4 property.
  • The property ID of the property you want to report on (shown in Admin → Property Settings).
  • A user role on the property that can view reports (Viewer or above).
  • The Google Analytics Data API enabled for your project.
  • An UnleashX account with access to Data Connectors.
No API key to paste. Google Analytics uses OAuth — you click Authorize and sign in with Google.
Google enforces your Analytics role. The Google Analytics Data API must be enabled, and your Google user needs at least Viewer access on the property — otherwise the agent can’t read its reports either. Ask your Analytics admin to grant access if needed.

​
3. Get your credentials

There’s no key to copy. Authentication runs through Google’s secure OAuth sign-in.
1

Start the connection in UnleashX

Connecting Google Analytics (Section 4) opens a Google Sign in window.
2

Sign in with Google

Sign in with the Google account that has access to your GA4 property. Complete two-factor authentication if prompted.
3

Review and accept the scopes

Google shows the access UnleashX is requesting (see the scopes table). Click Allow.
4

Confirm your property

If you have access to multiple GA4 properties, note the property ID of the one you want to report on. The agent uses it when running reports.
5

Return to UnleashX

Google redirects you back automatically and the connector links to your Analytics account. Behind the scenes UnleashX authenticates with Google using an OAuth token — you never handle the token yourself.
Permissions (Google OAuth scopes) UnleashX requests:
Google OAuth scopes are granular. UnleashX requests read-only access, and Google — together with your Analytics role — enforces the limits.

​
4. Connect on UnleashX

1

Open your agent

Go to https://www.tryunleashx.com and open the agent you want to connect.
2

Open Data Connectors

Inside the agent, go to Data Connectors.
3

Find Google Analytics

Locate Google Analytics and click Connect (or Add / Configure).
4

Authorize with Google

Click Authorize, sign in with Google, and accept the scopes.
5

Confirm success

You return to UnleashX and the Google Analytics connector shows a Connected badge.

​
Use Google Analytics in a Workflow

Once connected, you can add Google Analytics to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.
1

Add a trigger node

Open Workflows → New Workflow. On the canvas, click + Add Trigger. In the Paths panel, open the Apps tab and select Google Analytics — its Triggers are listed underneath. Use the search box if you have many connectors.
2

Add an action node

Click the + below any node to add a step, then pick Google Analytics again — this time the panel lists its Actions.
3

Configure the step

Fill in the fields for the trigger or action you picked. Required fields are marked with a red asterisk (*).
4

Add or select your account

Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5

Save and test

Click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.

​
5. Available tools

​
Available triggers

​
6. Example usage

“How many users and sessions did our main site get last week?” → Runs Run Report with users and sessions metrics over the last-week date range and returns the totals. “How many people are on the site right now, and which pages are they viewing?” → Runs Run Realtime Report to return active users and their current pages.

​
7. Permissions & data access

UnleashX can:
  • List the GA4 accounts and properties you can access.
  • Read a property’s details.
  • Run standard and realtime analytics reports.
UnleashX cannot:
  • Change property settings, data streams, or your analytics configuration (this connector is read-focused).
  • Do anything your Analytics role doesn’t permit.
  • Access properties your Google user hasn’t been granted.
To disconnect: In UnleashX, open Data Connectors → Google Analytics → Disconnect. You can also revoke access at https://myaccount.google.com/permissions (Third-party apps with account access). Disconnecting revokes access immediately.

​
8. Troubleshooting

For general MCP issues, see /mcp/integrations.

​
9. Frequently asked questions

Is my analytics data stored by UnleashX? No. UnleashX runs reports live through the Google Analytics Data API per request; it doesn’t keep a copy of your metrics. Which property does the agent report on? The property whose ID you point it at. If you manage several, the agent can list them and you specify which to use. Can the agent change my Analytics setup? No. This connector is read-focused — it reads accounts, properties, and reports but doesn’t change your configuration. Does this work with Universal Analytics? No. This connector uses the GA4 Data API. Universal Analytics properties have been retired by Google.

​
10. References