Tag Pilot GA4
Free, read-only Google Analytics 4 reports, funnels and realtime for AI clients
- 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-mcpAdd 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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data