Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Google Analytics 4 with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Query GA4 analytics data via Google Analytics API. run reports, check realtime data, analyze funnels, and export audiences directly from any AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 12 capabilities

The complete Google Analytics 4 capability set.

These are the exact actions your AI can choose when you ask it to work with Google Analytics 4.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 12 available through Google Analytics 4.

  1. 01

    Batch run reports

    Provide property_id and an array of report configurations. Each report can have different metrics, dimensions, and date ranges. This is efficient for dashboard loading or comparative analysis. The reports parameter should be a JSON array of report objects with metrics, dimensions, and dateRanges. Run multiple reports in a single API call

  2. 02

    Get metadata

    This includes both standard and custom metrics/dimensions with their descriptions, types, and compatibility information. Use this to discover what data is available before building reports. The propertyId is required and can be found in your GA4 admin settings. Get available metrics and dimensions for a GA4 property

  3. 03

    Run report

    You must provide the property_id, metrics (e.g., 'activeUsers', 'screenPageViews', 'eventCount'), and dimensions (e.g., 'city', 'pageTitle', 'sessionDefaultChannelGrouping'). Date ranges use YYYY-MM-DD format. Optional filter expression can narrow results. Common metrics: activeUsers, screenPageViews, sessions, eventCount, engagementRate, averageSessionDuration. Common dimensions: city, country, deviceCategory, sessionDefaultChannelGrouping, pageTitle, pagePath. Run a custom Google Analytics report

  4. 04

    Check compatibility

    Before running complex reports, use this to ensure compatibility between your chosen metrics and dimensions. This prevents errors and wasted API calls. Provide property_id and the metrics/dimensions you plan to use. Returns compatibility status and any conflicts that would prevent the report from running successfully. Check if metrics and dimensions can be combined in a report

Capability set02 / 03

05-08

4 capabilities in this set.

Part of 12 available through Google Analytics 4.

  1. 05

    Get audience export

    Audience exports allow you to extract user lists matching specific audience criteria. Use this to monitor the progress of audience extraction jobs. Provide property_id and the audience_export_id from list_audience_exports. Get status of a specific audience export

  2. 06

    List accounts

    This is the top-level container for properties. Each account can contain multiple properties. Use this to discover what accounts are available before drilling down into properties. List all Google Analytics accounts accessible to the user

  3. 07

    Get property

    Use the property_id obtained from list_properties to inspect property configuration. Get detailed information about a specific GA4 property

  4. 08

    Get user activity

    This shows all interactions a user has had with your property, including pageviews, events, and conversions. Use this for user-level analysis, journey mapping, or support investigations. The userId must match the one sent with your tracking events. Get activity history for a specific user

Capability set03 / 03

09-12

4 capabilities in this set.

Part of 12 available through Google Analytics 4.

  1. 09

    List audience exports

    Audience exports are used to extract user lists matching specific audience criteria for activation in other platforms. Shows status (CREATING, ACTIVE, FAILED) and configuration of each export job. List all audience export jobs for a property

  2. 10

    List properties

    Properties represent individual websites, apps, or measurement streams. Each property has a unique ID needed for running reports. Use this to find the correct property_id for report queries. List all GA4 properties in an account

  3. 11

    Run funnel report

    This helps identify where users drop off in conversion paths like checkout flows or signup processes. Provide property_id and a funnelSpec object defining the steps and breakdown settings. The funnelSpec should be a JSON object with steps array containing stepName, filterExpression, and optional breakdown settings. Run a funnel analysis report

  4. 12

    Run realtime report

    Unlike standard reports, this shows what's happening on your site/app right now. Provide property_id and the metrics/dimensions you want to monitor in realtime. Common realtime metrics: activeUsers, eventCount, screenPageViews. Common realtime dimensions: city, country, deviceCategory, streamId. Get realtime analytics data (last 30-60 minutes)

Observed, not estimated

870ms average. Fast in production.

Google Analytics 4 is checked daily against the live service.

Daily averagePeak 1128ms
Aug 20Today
Fastest day
742ms
Slowest day
1128ms
14-day trend
Slowing+6%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Google Analytics 4, so you can see the experience inside your AI.

It does not authenticate your account with Google Analytics 4. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Google Analytics 4 Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_v8thcnqdwIs5ecz18LHuEc3p1uB6nf8I9CCTGT2t/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Google Analytics 4 capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "google-analytics-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_v8thcnqdwIs5ecz18LHuEc3p1uB6nf8I9CCTGT2t/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Google Analytics 4 owners ask.

  • 01

    How do I get a Google Analytics API key and what type of credentials do I need?

    You need an API Key from Google Cloud Console. Go to console.cloud.google.com → Select or create a project → Enable the Google Analytics Data API v1 → Navigate to APIs & Services > Credentials → Click Create Credentials > API Key. Copy the key (starts with AIzaSy...). Then, in Google Analytics Admin, add the service account email with Viewer or Analyst role to your GA4 property. Paste the API key below.

  • 02

    What metrics and dimensions are available in GA4 and how do I find them?

    Use the get_metadata capability with your property_id to list all available metrics and dimensions. Common metrics include: activeUsers, screenPageViews, sessions, eventCount, engagementRate, averageSessionDuration, conversions. Common dimensions include: city, country, deviceCategory, sessionDefaultChannelGrouping, pageTitle, pagePath, streamName. The metadata response shows descriptions, types, and whether each field is a metric or dimension.

  • 03

    Can I get realtime data and how far back does it go?

    Yes! Use the run_realtime_report capability to get data from the last 30-60 minutes. Realtime reports show active users, events, and traffic sources as they happen on your site. This is useful for monitoring campaign launches, tracking live events, or checking if tracking is working correctly. Unlike standard reports which can take 24-48 hours to process, realtime data is available within minutes.

  • 04

    How do I analyze funnel conversion rates and identify drop-off points?

    Use the run_funnel_report capability with a funnel_spec JSON object defining your conversion steps. Each step includes a stepName, filterExpression (e.g., eventName equals 'page_view'), and optional breakdown settings. The response shows how many users entered each step, how many completed it, and where the biggest drop-offs occurred. This helps identify friction points in checkout flows, signup processes, or any multi-step user journey.

Explore

More in Industry Titans

Suggestions