How to Use the Google Analytics MCP in Mastra AI

Q: How do I register the Google Analytics MCP Server inside a Mastra AI agent?

Install @mastra/mcp@latest and initialize new MCPClient with the server URL. Call listTools() on the client instance to spread the GA4 tools directly into your agent's tool array.

Q: Can Mastra AI handle multi-step Google Analytics reporting pipelines?

Yes, you can build workflows that first use getmetadata to find valid metrics, then run runreport to fetch the data. Mastra handles the state management and passes outputs between these steps automatically.

Q: Does Mastra AI support human review for GA4 operations?

Yes, using the requireToolApproval configuration, you can pause the workflow before tools like getuseractivity execute. This ensures a human always reviews access to sensitive user tracking data.

Automate Google Analytics reporting workflows in Mastra AI with built-in retries and conditional branching.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Analytics MCP to Mastra AI

Create your Vinkius account to connect Google Analytics to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Google Analytics with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Reliable funnel reports in Mastra AI

The `run_funnel_report` tool calculates conversion drops across your checkout steps inside a Mastra AI workflow. If the Google API rate limit kicks in, Mastra uses its built-in exponential backoff to retry the query automatically. This setup ensures your automated marketing workflows never break due to transient API errors. You spread the tools from `listTools()` into your Mastra agent to use this MCP configuration.

Human-in-the-loop audience extraction

The `list_audience_exports` tool retrieves the status of your current user extraction jobs so your agent can monitor their progress. To prevent accidental data leaks, you can enable `requireToolApproval` in Mastra before triggering the actual export. Once approved, the agent uses `get_audience_export` to fetch the completed list. This workflow gives you a secure, automated pipeline for syncing GA4 audiences to other platforms.

Audit GA4 properties using this MCP Server

The `list_properties` tool scans all analytical assets associated with your GA4 account to find configuration discrepancies. Mastra agents can cross-reference these properties against your internal databases to flag missing tracking streams. By feeding this data into a conditional workflow, you can automatically notify your team when a new site goes live without tracking. This keeps your analytics coverage complete across all digital storefronts.

Setup guide

Set up Google Analytics MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Google Analytics tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "google-analytics-mcp-client",
  servers: {
    "google-analytics-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Google Analytics Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Google Analytics tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Google Analytics transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Google Analytics 4. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Google Analytics now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Google Analytics MCP in Mastra AI

Install `@mastra/mcp@latest` and initialize `new MCPClient` with the server URL. Call `listTools()` on the client instance to spread the GA4 tools directly into your agent's tool array.

Yes, you can build workflows that first use `get_metadata` to find valid metrics, then run `run_report` to fetch the data. Mastra handles the state management and passes outputs between these steps automatically.

You can design your workflow to cache reports locally or use conditional blocks that only query GA4 when cached data expires. This prevents your agents from running redundant queries during high-frequency loops.

Yes, using the `requireToolApproval` configuration, you can pause the workflow before tools like `get_user_activity` execute. This ensures a human always reviews access to sensitive user tracking data.

Credentials stay secure in your environment variables and never pass through third-party servers. The MCP server runs within an ephemeral V8 sandbox that destroys all session memory as soon as the workflow completes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript