# Tag Pilot GA4

> Tag Pilot GA4 is an open-source MCP server for analytics and data. Free, read-only Google Analytics 4 reports, funnels and realtime for AI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://tagpilot.io/ga4-mcp
- **Repository:** https://github.com/tagpilot/ga4-mcp/tree/HEAD/packages/ga4-mcp
- **MCP Registry name:** io.github.tagpilot/ga4-mcp
- **Categories:** analytics and data, marketing and SEO
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/tag-pilot-ga4
