Skip to content
MCP server

Tag Pilot GA4

Free, read-only Google Analytics 4 reports, funnels and realtime for AI clients

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.3.0
Listing updated
2 days ago

About Tag Pilot GA4

Tag Pilot GA4 is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

What sets it apart from Google's own experimental GA4 server is setup: there is no Google Cloud project, OAuth client, service account or gcloud. You add the package, ask a GA4 question, and approve once in the browser, first with a free Tag Pilot account and then with the Google account that can see your properties. The only scope requested is See and download your Google Analytics data, so it cannot change anything.

The server runs on your computer and requests reports directly from Google's APIs, so GA4 data does not pass through Tag Pilot's servers. It has 10 read-only tools covering reports, funnels, realtime, property setup audits and Tag Pilot tracking-health checks; connect and connection_status handle the sign-in link and its status. Example questions include which channels drove purchases last week and where users drop off between view_item and purchase.

It is Apache-2.0 licensed on npm as @tagpilot/ga4-mcp and needs Node.js 18 or newer, except as a Claude Desktop extension. An API key is only for CI or headless setups.

Install

Run in a terminal

claude mcp add ga4-mcp --env TAGPILOT_API_KEY='<TAGPILOT_API_KEY>' -- npx -y @tagpilot/ga4-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ga4-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/ga4-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ga4-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/ga4-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ga4-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/ga4-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ga4-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/ga4-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "ga4-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tagpilot/ga4-mcp"
      ],
      "env": {
        "TAGPILOT_API_KEY": "<TAGPILOT_API_KEY>"
      }
    }
  }
}

Configuration

  • TAGPILOT_API_KEYOptional. Leave unset: the first GA4 question connects this device to your free Tag Pilot account in the browser. Set a ga4:mcp key (tpk_…) only for CI or headless setups.
  • GA4_MCP_NO_BROWSERSet to 1 to only return the Google sign-in link (open it in any browser) instead of opening a browser.
  • GA4_MCP_AUTH_WAIT_SECONDSHow long a tool call waits for the browser sign-in before returning the link.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

connect
Starts the browser sign-in and returns a link and code.
connection_status
Checks whether the device has been approved.

What it does

No Google Cloud setup
One sign-in replaces a project, OAuth client and gcloud.
Read-only scope
Requests only permission to view Analytics data.
Data goes straight to Google
Reports are fetched from your machine, not via Tag Pilot.
Funnels and realtime
Drop-off analysis and live traffic questions.
Setup audits
Tracking-health and property setup checks.
Many clients
Claude Desktop, Claude Code, Cursor, VS Code and Gemini CLI.

Good for

  • Ask which channels drove purchases last week
  • Find where users leave a checkout funnel
  • Compare revenue by device over 30 days
  • Audit whether GA4 tracking is healthy

Pricing

Open source

Free with a Tag Pilot account; Apache-2.0

Prices change. Check tagpilot.io before you buy.

Tag Pilot GA4 FAQ

Is it free?

Yes, with a free Tag Pilot account.

Can it change my GA4 setup?

No. It is read-only.

What is needed for CI?

A ga4:mcp API key (tpk_) set in TAGPILOT_API_KEY instead of the browser sign-in.

What does it need to run?

Node.js 18 or newer, except for the Claude Desktop extension.

Is Tag Pilot GA4 free?

Yes. Tag Pilot GA4 is open source, so you can use and self-host it for free.

How do I add Tag Pilot GA4 to Claude Code?

Run this command in your terminal: claude mcp add ga4-mcp --env TAGPILOT_API_KEY='<TAGPILOT_API_KEY>' -- npx -y @tagpilot/ga4-mcp

What are the best alternatives to Tag Pilot GA4?

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

Alternatives to Tag Pilot GA4

  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