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
claude mcp add --transport http ga4 https://mcp.querysail.com/ga4/mcpWhat 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/mcpPlatform CLI: remote server
codex mcp add querysail-google-analytics --url https://mcp.querysail.com/ga4/mcpConfig file
{
"mcpServers": {
"querysail-google-analytics": {
"url": "https://mcp.querysail.com/ga4/mcp"
}
}
}Config file
{
"servers": {
"querysail-google-analytics": {
"type": "http",
"url": "https://mcp.querysail.com/ga4/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http querysail-google-analytics https://mcp.querysail.com/ga4/mcpStep 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.