Add Sprites to Gemini
Available on Gemini CLI, free and paid, on macOS, Linux and Windows. You need a Sprites account with Google Analytics 4 already connected — the connector acts on that connection, so Gemini never handles a GA4 credential.
Open the Gemini settings file
Gemini CLI keeps MCP servers in its settings JSON. Use ~/.gemini/settings.json to have Sprites available everywhere, or .gemini/settings.json inside a project to scope it there.
Gemini CLI~/.geminisettings.jsonAdd Sprites under mcpServers
Use httpUrl, not url or command — that is the key Gemini CLI reads for a streamable HTTP endpoint. A url entry is treated as SSE and a command entry as a local process, and neither is what this is.
~/.gemini/settings.json{ "mcpServers": { "sprites": { "httpUrl": "https://mcp.sprites.ai/mcp" } } }Sign in
Gemini CLI supports OAuth 2.0 for remote servers and discovers the authorization server from the endpoint itself. Restart the CLI, and the first call opens a browser for the Sprites consent screen; the token is stored in ~/.gemini/mcp-oauth-tokens.json.
Spriteswants access on behalf of Gemini- Read your connected ad accounts and site data
- Draft campaigns, creatives and pages for your approval
- Apply only the changes you approve
AllowCancelCheck it landed
Type /mcp in the CLI to list every server and the tools it exposes, or run gemini mcp list from a shell to see connection status without opening a session.
Terminalgemini mcp list
Run the first prompt
Ask Gemini this. It routes to a Sprites door, which reads your Google Analytics 4 account and answers — no account to name, no confirmation to give first.
- With Sprites, what happened to conversions last week and which channel caused it?
- Ask Sprites for our top 10 landing pages by conversion rate this month.
- Use Sprites to compare organic and paid revenue quarter over quarter in GA4.
- Have Sprites break down ecommerce revenue by product for the last 30 days.
- With Sprites, set up a Monday brief on traffic, conversions and the biggest change.
Run `gemini mcp list`, or type /mcp inside the CLI — Sprites should show as connected with its tools listed.
What Gemini can do with Google Analytics 4
The same doors, whichever client you are in. The account and the analytics are already Google: Gemini reads Google Ads and GA4 alongside Search Console without leaving the family it belongs to.
Ask in English, get the report run
No explorations, no dimension picker. The question becomes a GA4 query and the answer comes back with the numbers attached.
Channel attribution that names a cause
Which source actually moved, separated from the one that merely moved with it.
Item-scoped ecommerce
Revenue, quantity and conversion rate per product, not just per session — the breakdown GA4 buries.
Landing pages that earn and landing pages that leak
Entry page performance against conversions, ranked, with the drop-off stated.
Join it to the ad accounts
Because the same connector reads Google Ads and Meta, a GA4 answer can be checked against what the platforms claim.
A standing weekly read
A scheduled brief that runs against GA4 and messages you only when a number breaks trend.
How approvals work here
Gemini renders tool results as text, so a GA4 change comes back written out rather than as a card. Nothing is applied until you approve it, and the approval waits for you in Sprites — open it there and the same run continues.
What it reads
- Sessions, users, engagement and conversions by any GA4 dimension
- Channel, source, medium and campaign attribution
- Landing pages, events and funnels
- Item-scoped ecommerce: revenue, quantity and per-product conversion
What it can change
- Nothing. GA4 is read-only through this connector by design
- Changes it recommends land on the ad or SEO channel they belong to, each with its own approval
When it does not work in Gemini
Three things go wrong in this client specifically, and each has a one-line fix.
Gemini connects but reports no tools.
The entry is probably using url rather than httpUrl, so the CLI is speaking SSE to a streamable HTTP endpoint. Change the key and restart.
Edits to settings.json do nothing.
The CLI reads its settings at startup. Restart it, then re-check with /mcp.
A project file and your home file disagree.
.gemini/settings.json in the working directory takes precedence. Keep Sprites in one of the two rather than both.
Google Analytics 4 and Gemini: questions
Which URL do I paste into Gemini?
https://mcp.sprites.ai/mcp. There is one endpoint and every client uses it — every OAuth grant is bound to exactly that address, so a variant of it will not be honoured.
Can Gemini change my Google Analytics 4 account without asking?
Gemini renders tool results as text, so a GA4 change comes back written out rather than as a card. Nothing is applied until you approve it, and the approval waits for you in Sprites — open it there and the same run continues.
Do I need a Google Analytics 4 API key or developer token?
No. Google Analytics 4 is connected once inside Sprites through Google Analytics 4, and the connector acts on that connection. Gemini never sees a credential for it.
Why Gemini for Google Analytics 4 specifically?
The account and the analytics are already Google: Gemini reads Google Ads and GA4 alongside Search Console without leaving the family it belongs to.
Can it change anything in GA4?
No. GA4 is read-only through this connector on purpose. If the answer implies a change, it is proposed on the channel that owns it — an ad account, a page — with its own approval.
Do I need to know GA4 dimensions and metrics?
No. You ask the question; Sprites picks the dimensions, runs the report and states what it queried so you can check the working.
Keep going
The same Gemini connector reaches every other channel — nothing else to add.
Google Analytics 4, from Gemini
Paste one URL, sign in once, and the next GA4 question you ask Gemini gets answered from the live account.