# QuerySail: Google Analytics

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: querysail
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/querysail/querysail-ga4
- Updated: 2026-10-11
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/querysail-google-analytics

## What it 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.

## Requirements
- Remote server: `https://mcp.querysail.com/ga4/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ga4 https://mcp.querysail.com/ga4/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add querysail-google-analytics --url https://mcp.querysail.com/ga4/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "querysail-google-analytics": {
            "url": "https://mcp.querysail.com/ga4/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "querysail-google-analytics": {
            "type": "http",
            "url": "https://mcp.querysail.com/ga4/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http querysail-google-analytics https://mcp.querysail.com/ga4/mcp
```

## When to use it
- 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
- 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

## Similar
- [google-analytics](https://affpapa.org/en/nevibecode/skills/google-analytics.md) — skill · 539 installs
- [pp-google-analytics](https://affpapa.org/en/nevibecode/skills/pp-google-analytics.md) — skill · 152 installs
- [google-analytics-automation](https://affpapa.org/en/nevibecode/skills/google-analytics-automation.md) — skill · 130 installs
- [Google Analytics 4 MCP](https://affpapa.org/en/nevibecode/mcp/google-analytics-4-mcp.md) — MCP server
- [anacraft — Google Analytics 4](https://affpapa.org/en/nevibecode/mcp/anacraft-google-analytics-4.md) — MCP server · ★ 1 repo stars
- [google-analytics-mcp](https://affpapa.org/en/nevibecode/mcp/google-analytics-mcp.md) — MCP server · ★ 243 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
