Google Analytics MCP Server for any AI client.

It's a remote MCP (Model Context Protocol) server at https://notfair.co/api/mcp/google_analytics that exposes your GA4 properties as a typed tool surface for AI agents. Claude Desktop, Claude.ai Web, Claude Cowork, Claude Code, and Codex can all connect to it and answer questions over live Google Analytics data — traffic sources, conversions, landing pages, and realtime activity.

Claude.ai's Add custom connector flow and Codex both use OAuth 2.0 with PKCE — there's no Client ID or Secret to copy. You authorize NotFair with Google once, pick which GA4 properties to expose, and the connection is scoped to those properties and revocable at any time.

The GA4 properties your Google account can access, Data API reports over any dimensions and metrics (sessions, users, conversions, revenue, traffic sources, pages, and more), realtime reports covering roughly the last 30 minutes, and the dimension/metric metadata for each property. Tokens are encrypted at rest and refreshed server-side.

Reporting is read-only and unrestricted. The only writes are configuration management — creating or archiving custom dimensions and creating or removing key events — and every write is approval-gated: the change is proposed in chat and you confirm before it reaches Google. The AI never touches your tracking code or your data.

Google splits the GA4 API in two: the Data API (reports, realtime, metadata) authorizes on analytics.readonly, while the Admin API writes NotFair exposes — custom dimensions and key events — require analytics.edit, which does not itself cover Data API reads. One grant requests both so reporting and the approval-gated configuration tools work from a single connection.

runRealtimeReport covers the present moment back to about 30 minutes. runReport reflects standard GA4 processing — today's rows are intraday and still changing, and high-cardinality or wide-range reports may be sampled (the response says so when they are). Dates are interpreted in the property's timezone.

From /connect/google_analytics you can revoke access at any time. That removes the stored credential and invalidates the Claude and Codex OAuth tokens issued for the connection. You can also revoke NotFair from your Google account permissions page.