Skip to content
MCP server

Google Analytics 4

Read-only Google Analytics 4 reports, funnels and tracking checks for AI assistants

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
2.1.2
Listing updated
2 days ago

About Google Analytics 4

Google Analytics 4 is a freemium MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

No tool here can write to GA4. It has 27 read tools, and the hosted version asks Google for the analytics.readonly scope only. Reports cover sessions, key events, purchases and revenue by channel, source, campaign, landing page, device and country, with pivots and funnels across 51 metrics and 62 dimensions, plus a realtime view of who is on the site now.

A distinctive part is the tracking audit: it checks whether view_item, add_to_cart, begin_checkout and purchase fire with revenue, how server-side tagging is set up and what the BigQuery export covers. Because the same hosted URL reaches Meta, Google Ads, TikTok and other ad platforms, one request can set GA4 numbers beside an ad platform's own, with each source keeping its own attribution and the two never added up.

Choose between the open-source stdio package, which needs your own OAuth client ID and secret and Node.js 22, 24 or 26, or the hosted getmcpads connection with Google sign-in and a tick-list of properties. The hosted version has a free plan for one account.

Install

Run in a terminal

claude mcp add google-analytics --env GA4_CLIENT_ID='<GA4_CLIENT_ID>' --env GA4_CLIENT_SECRET='<GA4_CLIENT_SECRET>' --env GA4_REFRESH_TOKEN='<GA4_REFRESH_TOKEN>' -- npx -y @getmcpads/google-analytics-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-analytics-mcp-server"
      ],
      "env": {
        "GA4_CLIENT_ID": "<GA4_CLIENT_ID>",
        "GA4_CLIENT_SECRET": "<GA4_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-analytics-mcp-server"
      ],
      "env": {
        "GA4_CLIENT_ID": "<GA4_CLIENT_ID>",
        "GA4_CLIENT_SECRET": "<GA4_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-analytics": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-analytics-mcp-server"
      ],
      "env": {
        "GA4_CLIENT_ID": "<GA4_CLIENT_ID>",
        "GA4_CLIENT_SECRET": "<GA4_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-analytics-mcp-server"
      ],
      "env": {
        "GA4_CLIENT_ID": "<GA4_CLIENT_ID>",
        "GA4_CLIENT_SECRET": "<GA4_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "@getmcpads/google-analytics-mcp-server"
      ],
      "env": {
        "GA4_CLIENT_ID": "<GA4_CLIENT_ID>",
        "GA4_CLIENT_SECRET": "<GA4_CLIENT_SECRET>",
        "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>"
      }
    }
  }
}

Configuration

  • GA4_CLIENT_IDOAuth client ID.Required
  • GA4_CLIENT_SECRETOAuth client secret.Required
  • GA4_REFRESH_TOKENOAuth refresh token, analytics.readonly scope.Required
  • GA4_PROPERTY_IDDefault GA4 property ID.
  • GA4_PROPERTY_IDSComma-separated property IDs every tool is limited to. Optional in 2.x, required in 3.0.0.

What it does

Reports and pivots
Channel, source, campaign, landing page, device and country with 51 metrics and 62 dimensions.
Funnels
Builds funnel reports, for example by device.
Realtime
Shows current visitors by device or country.
E-commerce checks
Verifies purchase-flow events fire with revenue.
Server-side and BigQuery review
Checks server-side tagging setup and BigQuery export coverage.
Read only
Requests only the analytics.readonly scope.

Good for

  • Break down purchases by channel and device
  • Check whether checkout events fire correctly
  • See who is on the site right now
  • Compare GA4 with an ad platform's reported conversions

Pricing

Freemium, from $39 a month

Free plan for 1 ad account (200 requests a month); Pro $39/month, Team $99/month; open-source servers can be self-hosted

Prices change. Check getmcpads.com before you buy.

Google Analytics 4 FAQ

Can it change my GA4 property?

No. It has no write tools and asks for the readonly scope only.

How many tools does it have?

27 read tools.

Do I need my own Google credentials?

The local package needs an OAuth client ID and secret; the hosted version uses Google sign-in.

Is there a free option?

The hosted plan is free for 1 ad account with 200 requests a month.

Is Google Analytics 4 free?

Google Analytics 4 has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.

How do I add Google Analytics 4 to Claude Code?

Run this command in your terminal: claude mcp add google-analytics --env GA4_CLIENT_ID='<GA4_CLIENT_ID>' --env GA4_CLIENT_SECRET='<GA4_CLIENT_SECRET>' --env GA4_REFRESH_TOKEN='<GA4_REFRESH_TOKEN>' -- npx -y @getmcpads/google-analytics-mcp-server

What are the best alternatives to Google Analytics 4?

The closest alternatives to Google Analytics 4 are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to Google Analytics 4

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data