What You'll Set Up
By the end of this guide, your AI agent will be able to pull data from your Google Analytics account — running reports on traffic, checking real-time visitor activity, listing your properties, and tracking conversion events. No manual key or credential is needed. You simply sign in with your Google account and Pipeworks handles the rest.
Your agent can answer questions like "How many visitors did we get last week?" or "What are our top landing pages this month?" using live data from your analytics account.
Before You Begin
Make sure you have:
- A Google Analytics account — Set one up at analytics.google.com if you haven't already. You need at least one GA4 property configured.
- A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already
Google Analytics is free to use. Make sure you have at least Viewer access to the properties you want your agent to report on.
Steps
Open your Pipeworks console
Log into your Pipeworks workspace and go to the Integrations page. Find Google Analytics in the list and click on it.
Sign in with Google
Click Connect with Google. You will be redirected to Google's sign-in page. Choose the Google account that has access to your Analytics properties and grant the requested permissions.
Pipeworks requests read access to your Analytics data. You can review the exact permissions on the Google consent screen before approving.
Authorize access
After signing in, Google will ask you to confirm that Pipeworks can access your Analytics data. Click Allow to complete the connection. You will be redirected back to your Pipeworks console.
Pipeworks securely stores your authorization using industry-standard encryption. Your Google password is never shared with Pipeworks.
Start the integration
Click Start to launch the Google Analytics integration container. Once the status shows Running, your agent is ready to query your analytics data.
Test the connection
Use the Test button to verify everything works. This sends a simple request to Google Analytics to confirm your connection is active and your properties are accessible.
What Your Agent Can Do
Once connected, your AI agent has access to Google Analytics tools for:
- Reports — Run custom reports on page views, sessions, users, bounce rate, and more
- Real-time data — Check how many people are on your site right now and what they are viewing
- Properties — List all your GA4 properties and their configurations
- Conversions — Track conversion events and goal completions
- Audience insights — Break down traffic by device, location, source, and other dimensions
Google Analytics tools are read-only by default — your agent can pull reports and data but cannot modify your Analytics configuration. This makes it safe to connect without worrying about accidental changes.
Connecting from Your AI Agent
Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:
{
"mcpServers": {
"pipeworks-google-analytics": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/google-analytics"]
}
}
}
Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.
Troubleshooting
Google sign-in fails? Make sure you are signing in with the Google account that has access to your Analytics properties. If you have multiple Google accounts, check that you selected the right one.
No properties showing up? Verify that your Google account has at least Viewer access to the GA4 properties you want to query. You can check this in Google Analytics under Admin > Property Access Management.
Connection expired? Google authorizations can expire over time. If your agent stops working, go to the Pipeworks console, click Disconnect, and reconnect by signing in with Google again.
Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.