How to Use the Google Analytics MCP in Claude

Q: Can Claude Desktop run multiple Google Analytics reports at the same time?

Yes, the server uses batchrunreports to bundle multiple configurations into one API call. This saves your daily quota and speeds up data gathering.

Query GA4 properties and pull raw marketing data directly inside Claude Desktop without switching tabs to the browser UI.

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 Claude Desktop

Create your Vinkius account to connect Google Analytics to Claude Desktop 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 Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run custom marketing reports in Claude Desktop

The `run_report` tool grabs specific metrics like active users or event counts directly from your GA4 property into your chat window. You provide the target property ID, choose your dimensions, and set the date range to get immediate tabular data. It cuts out the manual export step entirely, letting you analyze traffic trends without opening a separate browser tab. If you need to look at multiple views at once, `batch_run_reports` lets your agent query several configurations in a single run. This MCP Server allows your agent to bundle these requests, keeping your API usage low while giving you the exact dataset needed to write your weekly summary.

Monitor live traffic trends

The `run_realtime_report` tool fetches active user counts and page views from the last thirty minutes directly into your workspace. This live feed lets your agent spot sudden traffic spikes or broken checkout paths during a product launch. You do not have to wait for the standard daily processing delay to see if your new campaign is working. Before firing off a complex query, the `check_compatibility` tool lets your agent verify if your selected dimensions and metrics work together. Using this MCP Server, your agent can verify combinations instantly, saving your daily token quota when building custom dashboards.

Analyze funnel drop-offs and user journeys

The `run_funnel_report` tool maps out step-by-step user paths to show exactly where potential customers abandon your checkout or signup flows. Your agent reads this structured funnel data to pinpoint specific friction points in your user experience. It replaces manual spreadsheet calculations with clean, structured JSON payloads. To inspect individual user histories, the `get_user_activity` tool pulls chronological event logs for specific user IDs. This granular view helps support teams trace technical bugs or onboarding issues that aggregate metrics often hide.

Setup guide

Set up Google Analytics MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Google Analytics MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Google Analytics MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under google-analytics-mcp.

json

{
  "mcpServers": {
    "google-analytics-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Claude Desktop

You add the server configuration to your local configuration file with your GA4 credentials. Once you restart the app, the hammer icon appears in your chat box, letting your agent run reports.

Yes, the server uses `batch_run_reports` to bundle multiple configurations into one API call. This saves your daily quota and speeds up data gathering.

This happens when you combine incompatible metrics and dimensions in your query. Your agent can run `check_compatibility` first to verify the combination works before hitting the GA4 API.

No, Vinkius hosts the server, so you only need to paste the connection string into your configuration file. Your agent handles the API calls in the background.

Your GA4 property IDs and OAuth tokens remain inside the Vinkius secure MCP sandbox. The server only passes raw JSON payloads to your agent, ensuring your credentials are never exposed to external logs.

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