Skip to main content
MCP server CX Codex

QuerySail GA4 — Claude Code MCP server: what it does, how to install

QuerySail: Google Analytics is an MCP server for Claude Code that connects Google Analytics 4 to your coding agent for traffic, period comparisons and realtime data, with no API keys.

MIT updated 2026-10-11

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http ga4 https://mcp.querysail.com/ga4/mcp
Open on GitHub

What QuerySail: Google Analytics does

QuerySail runs as a hosted MCP server over HTTP, so there's nothing to install locally, though you do need a querysail.com account with your Google login linked first. It exposes five tools: list_properties lists the GA4 properties you can access, list_fields returns the dimensions and metrics available for one, run_report pulls users, sessions, events and revenue broken down by channel, page, device or country, compare_report lines up two time periods to show what moved, and run_realtime_report covers activity from the last 30 minutes.

Every tool is read-only, so there's no way to edit GA4 properties, streams or audiences through this server. Reports are cached for up to 15 minutes while realtime data skips caching entirely, and Universal Analytics properties fall outside what it can query. Google's own API quotas and any thresholding or sampling still apply underneath, and the server just forwards those flags along.

Claude Code can add it directly with claude mcp add, or through the marketplace plugin, which throws in a GA4 analysis skill on top. Clients that can't reach a remote server directly can fall back to the mcp-remote bridge, which needs Node.js installed.

What it helps with

  • pull a traffic and conversion report without opening the GA4 dashboard
  • compare this period against last month or the same weeks last year by channel
  • check live visitor counts and their countries in real time
  • find top landing pages ranked by key events
  • list available GA4 properties and metrics without digging through settings

Example prompts for the agent

  • How many users and sessions did my site get over the last 28 days?
  • Which channels drove the most sessions last month, and how does that compare to the month before?
  • Compare organic search sessions against the same weeks last year

How to install QuerySail: Google Analytics

Platform CLI: remote server

claude mcp add --transport http ga4 https://mcp.querysail.com/ga4/mcp

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about QuerySail: Google Analytics

How do I install QuerySail GA4 in Claude Code?

Run claude mcp add --transport http ga4 https://mcp.querysail.com/ga4/mcp, then run /mcp, pick the server and sign in with Google. There's also a namespaced variant: claude mcp add --transport http querysail-google-analytics https://mcp.querysail.com/ga4/mcp.

What does QuerySail GA4 do?

It's an MCP server that answers plain-language questions about a site's traffic, engagement and conversions using Google Analytics 4 data. It builds reports, compares time periods and surfaces realtime activity, but can't change any GA4 settings.

Do I need a Google Cloud API key to use QuerySail GA4?

No, there's no Google Cloud project or API key to set up. A querysail.com account with Google connected through OAuth is enough.

Similar MCP servers

All MCP servers for Marketing and content →

Project sponsors

Companies that keep this analytics open