By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect Gemini to Google Analytics is the Ryze AI connector. Link your GA4 property to a Ryze AI workspace through Google sign-in and save it there, then paste https://connector.get-ryze.ai/mcp into the Gemini web app as a custom app under Settings, Connected Apps, and call it with @ in a prompt. Gemini CLI takes the same address through one gemini mcp add command. Gemini then reads GA4 through 9 read-only tools. Google opens custom apps only to people 18 or over in the US, on a personal Google Account, in English.
- In Ryze AI open Integrations, find Google Analytics 4 under Analytics and click Connect
- Sign in with Google, approve access and save the Property for the workspace
- In gemini.google.com open Settings, Connected Apps, Add a custom app and paste the URL
- Sign in on the Ryze AI page, choose workspaces, click Allow connection, then type @ and pick Ryze AI
Gemini to Google Analytics at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, added once per Gemini surface: a custom app in the web app, or one gemini mcp add command in Gemini CLI |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | Google inside Ryze AI (read-only scope), then Ryze AI from Gemini, with no client ID to type. Gemini CLI also takes a Ryze AI API key header |
| GA4 tools | 9, all read tools, 4 of them for visits from AI assistants |
| Can Gemini change GA4 | No. No tool writes to GA4, and the Google scope is analytics.readonly |
| Who may add a custom app | Adults 18 or over in the US with a personal Google Account, Keep Activity on and Gemini in English |
| Gemini plan needed | The custom apps page names none. Gemini CLI has not served Google AI Pro, Ultra or free Code Assist for individuals since June 18, 2026 |
| GA4 access needed | At least the Viewer role on the property, for the Google login you connect |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector costs nothing |
| Google's own option for Gemini | analytics-mcp, an open-source server run on your computer. Its README covers Gemini CLI and Gemini Code Assist, not the Gemini app |
| Last tested | Connector on November 13, 2026; 8 GA4 calls from Claude Code on November 14, 2026. Nothing run inside Gemini |
Before you start
- A Gemini account that Google allows. Google's help page for custom apps requires you to be 18 or over and in the US, signed in with a personal Google Account (not a work or school account), with Keep Activity on. The feature is English only, and the page names no paid plan.
- Viewer access or higher on a GA4 property. The Google login you connect in Ryze AI needs at least Viewer on the property. Ryze AI asks for the read-only Google Analytics scope (analytics.readonly) plus basic profile scopes, so keep every requested permission checked on the Google screen. Universal Analytics is not supported.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, and annual billing takes 30% off the first year. Connecting the connector is free; the GA4 tools need an active plan or trial.
- Trust in the server. Google states it does not control, monitor or secure third-party MCP servers, so you decide whether to trust a provider before you connect.
How to connect Gemini to Google Analytics in the web app
Setup has two parts. GA4 is connected inside Ryze AI first, and then Gemini is pointed at the Ryze AI connector. Google lets you add custom apps only in the Gemini web app, either on a computer or at gemini.google.com in a phone or tablet browser; once added, they also work in the Gemini mobile app.
Connect Google Analytics 4 in Ryze AI
Create a Ryze AI account or sign in, open Integrations in the left sidebar and find Google Analytics 4 under Analytics. Click Connect, sign in to Google and approve access, keeping every requested permission checked.
Save the GA4 property
Back in Ryze AI, pick the Property for this workspace (listed as account and property) and click Save. Until a Property is saved the card shows Require setup.
Open Connected Apps in Gemini
On a computer go to gemini.google.com. At the bottom click Settings, then Connected Apps. If Connected Apps is missing, click Personal Intelligence first and then Connected Apps. In a phone or tablet browser, Settings sits under Menu at the left.
Add a custom app with the Ryze AI URL
Under Custom apps use the Add a custom app link to get started field, or click Add a custom app if one is already connected. Enter https://connector.get-ryze.ai/mcp and click Next. Ryze AI supports dynamic client registration, so the credential fields under Advanced features stay empty.
Allow the workspace
Follow the on-screen instructions: sign in on the Ryze AI page, choose the workspaces that hold your GA4 connection and click Allow connection.
Use the app in a prompt
In a new prompt type @ and select the Ryze AI app, then ask a first question, for example: Which AI assistants sent visits to my site in the last 30 days?
Sources: Google's Gemini help page on custom apps and its phone version. Checked November 14, 2026. The Ryze AI Google Analytics guide covers the Google sign-in on the Ryze AI side.
Gemini CLI
Gemini CLI reads MCP servers from the command line. This command registers the Ryze AI connector at user scope, so every project can use it (the default scope is project):
gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcpStart Gemini CLI. On the first 401 it discovers OAuth, registers a client and opens a browser for the Ryze AI sign-in; /mcp auth ryze starts or repeats that sign-in. OAuth needs a local browser and a localhost callback, so it does not work in headless environments, in SSH sessions without X11 forwarding or in containers that have no browser.
Prefer the settings file? Add this entry to settings.json:
{
"mcpServers": {
"ryze": { "httpUrl": "https://connector.get-ryze.ai/mcp" }
}
}On a machine without a browser, create a Ryze AI API key and send it as a header in place of OAuth: gemini mcp add --transport http -s user --header "Authorization: Bearer rk_live_..." ryze https://connector.get-ryze.ai/mcp. The includeTools and excludeTools settings in settings.json filter which tools Gemini CLI can call.
Source: Gemini CLI MCP server docs. Checked November 14, 2026.
Antigravity CLI and Gemini Enterprise
Antigravity CLI
Google's May 19, 2026 announcement says that since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users or people using it free of charge through Gemini Code Assist for individuals, and it points them to Antigravity CLI. Gemini CLI remains available with Gemini Code Assist Standard or Enterprise licenses and with paid Gemini or Gemini Enterprise Agent Platform API keys. This guide gives no Antigravity CLI steps.
Gemini Enterprise
Gemini Enterprise has an administrator process in the Google Cloud console for custom MCP servers. It accepts StreamableHTTP only and enables up to 100 actions at a time. For sign-in it offers OAuth 2.0 with a pre-registered client ID and secret, or no authentication at all. Ryze AI documents no such client, so this guide gives no Gemini Enterprise steps.
Sources: Google Developers Blog on Gemini CLI and Antigravity CLI, Gemini Enterprise custom MCP server setup. Checked November 14, 2026.
Gemini and MCP: Google's rules in one table
The Gemini app and Gemini CLI handle MCP servers in different ways. This table sets Google's rules for the two side by side.
| Topic | Gemini web and mobile app | Gemini CLI |
|---|---|---|
| Where a server is added | Settings, Connected Apps, Custom apps. Google's help page links that screen at gemini.google.com/apps. A remote URL only, with no field for a command | gemini mcp add, or an mcpServers entry in ~/.gemini/settings.json (user) or .gemini/settings.json (project). A URL or a local program |
| Transport | The help page names none. It asks only that the server follows the standard MCP specifications | stdio, SSE and Streamable HTTP. The add command picks stdio unless --transport says otherwise |
| Sign-in | The URL alone when the server offers dynamic client registration; otherwise credentials under Advanced features. The page documents no header or API key field | OAuth discovery after a 401, tokens kept in ~/.gemini/mcp-oauth-tokens.json. A headers object or -H can carry an API key instead |
| Tool approval | Gemini asks you to confirm every write action by hand. The page says nothing about reads | A prompt on each call with Proceed once, Always allow this tool, Always allow this server and Cancel. trust: true turns the prompts off |
| Narrowing the tools | The page describes switching the whole app off and no per-tool setting | includeTools and excludeTools (excludeTools wins), plus allow, deny or ask_user rules in ~/.gemini/policies/ |
| Plan | None named for custom apps. Tasks, which can also call a custom app, need Google AI Pro or Ultra | Code Assist Standard or Enterprise licenses and paid API keys keep access. Google AI Pro, Ultra and free Code Assist for individuals lost it on June 18, 2026 |
| Admin controls | None described. Work and school accounts cannot add custom apps for now | mcp.allowed and mcp.excluded, admin.mcp.enabled, and a system settings file whose servers a user cannot redefine |
| Where servers are managed | The Custom apps list: a switch to turn the app off, then More details for Disconnect or Remove app | /mcp list, /mcp auth, /mcp enable and /mcp disable in a session; gemini mcp remove in the shell |
Sources: Gemini custom apps help, Gemini tasks help, Gemini CLI MCP servers, Gemini CLI policy engine, Gemini CLI for enterprise, Gemini CLI configuration. Checked November 14, 2026.
Which properties Gemini can reach
Gemini does not pick a property on its own. The GA4 tools take a property ID, and one of them lists the accounts and properties your connected Google login can access, so you can start by asking for that list.
- Ask Gemini to list the GA4 accounts and properties you can access, using google_analytics__listAccountSummaries.
- Name the property you want in your next prompt, by its name or ID.
- If you connected more than one Google login in Ryze AI, name the property in chat; the starred login is the primary one the agent uses by default.
Several Google logins can sit in one workspace through Add one more account in Ryze AI, each with its own Property. Tools accept an optional connection_id to target one connected account. For separate clients the Ryze AI help center advises one workspace per client.
Property access and scopes
Two sign-ins are involved, and each limits what Gemini can reach.
- Which Google login
- The login you approve on the Ryze AI Connect step. It needs at least Viewer on the GA4 property, and the Property you save in Ryze AI is the one the workspace uses.
- What the login can do
- Read only. The scope is analytics.readonly, and none of the 9 GA4 tools writes to GA4.
- Which Gemini surface
- The Gemini web app is limited to personal Google Accounts in the US, in English. Gemini CLI signs in through a browser, or with an API key sent as a header.
Ryze AI requests the read-only Google Analytics scope (analytics.readonly) plus basic profile scopes. Keep every requested permission checked on the Google screen, or the connection will not work.
What the Google sign-in grants, and what it leaves out
Ryze AI reads GA4 as your Google user, through the consent you give on Google's screen: no API key, no service account, and no Google Cloud project or OAuth client of your own.
| Scope or role | How Google describes it | What it means for Gemini |
|---|---|---|
| analytics.readonly | See and download your Google Analytics data | The 9 tools can read reports and settings on any property where the login holds a role |
| openid, email, profile | Associate you with your personal info on Google; See your primary Google Account email address; See your personal info | Basic profile sign-in, no GA4 data |
| Viewer role on the property | Can see settings and data; can change which data appears in reports (e.g., add comparisons, add a secondary dimension); can see shared assets via the user interface or the APIs. | The lowest role that works. Google's own MCP server asks for the same minimum |
| No Cost Metrics or No Revenue Metrics | Cannot see metrics related to cost. Cannot see metrics related to revenue | Google applies these limits in the API too, so Gemini will not see those metrics either |
Never requested: analytics.edit (Google: Edit Google Analytics management entities) and analytics.chatbot.read, the Ask Advisor scope. Marketer and Editor roles are not needed, so Gemini can report on a key event or audience but cannot create or delete one.
The second sign-in, from Gemini to Ryze AI, is a separate OAuth flow on the connector. Its discovery files name two scopes, mcp:read and mcp:write. Which of them Gemini asks for was not checked for this page.
Sources: Google OAuth 2.0 scopes, GA4 roles and data restrictions, Google Analytics MCP server README. Checked November 14, 2026.
Removing access
To remove access, disconnect Google Analytics 4 on its card in Ryze AI Integrations. In the Gemini app, under Settings, Connected Apps, Custom apps, switch Ryze AI off, or open More details and pick Disconnect (it stays listed, with its permissions revoked) or Remove app. Your Google Account's Linked apps page can unlink it too, and the Google Account permissions page lists the Google sign-in you gave Ryze AI, where you can revoke it. In Gemini CLI run gemini mcp remove ryze.
What Gemini can do in Google Analytics
The Ryze AI connector exposes 9 Google Analytics 4 tools. All 9 are read tools, and there are no GA4 write tools.
| Tool | Type | What it does |
|---|---|---|
| google_analytics__listAccountSummaries | Read | Lists the GA4 accounts and properties the connected Google login can access, so you can find property IDs. |
| google_analytics__runRawReport | Read | Runs a GA4 Data API runReport with chosen dimensions, metrics, named date ranges, filters and ordering. |
| google_analytics__runPivotReport | Read | Runs a GA4 Data API pivot-table report. |
| google_analytics__runRealtimeReport | Read | Runs a realtime report covering the last 30 minutes. |
| google_analytics__runAdminRead | Read | Reads a GA4 Admin API resource such as key events, custom dimensions or audiences. It is GET only. |
| google_analytics__getAiTrafficByEngine | Read | Returns traffic from AI referrers grouped by source engine and compared with a prior period. |
| google_analytics__getAiTrafficDaily | Read | Returns daily traffic from AI referrers such as ChatGPT and Perplexity. |
| google_analytics__getAiLandingPages | Read | Lists the top landing pages that receive AI-referred traffic, up to 200 rows. |
| google_analytics__getAIReferrals | Read | Lists AI referral sources with their sessions and conversions. |
Because every GA4 tool only reads, nothing in your property changes. Google's help page says Gemini requires manual confirmation for any write actions and is silent about reads, so whether Gemini stops to ask before a GA4 read was not checked. In Gemini CLI the default asks before tool calls, and setting trust to true (or passing --trust) bypasses all confirmations, so leave it off for this server. In the Ryze AI chat the Tool approvals setting starts on Skip all approvals and can be switched to Approve write & delete or Manual approve.
Limits in numbers
| Limit | Number | Source |
|---|---|---|
| Core tokens per day | 200,000 per standard property, 2,000,000 on Analytics 360. Refilled at midnight Pacific time | Data API quotas |
| Core tokens per hour | 40,000 per standard property (400,000 on 360), of which one Google Cloud project may use 14,000 | Data API quotas |
| Requests at the same time | 10 per standard property, 50 on 360 | Data API quotas |
| Typical cost of one report | 10 tokens or fewer. Long date ranges, many rows, complex filters and dimensions such as pagePath cost more | Data API quotas |
| When a bucket reaches 0 | 429 RESOURCE_EXHAUSTED for every further request to the property. Hourly buckets refill within an hour | Data API quotas |
| Requests that fail | 10,000 per project and property in a 15-minute window, then the project is blocked on that property until the window ends | Data API changelog |
| Rows in one report | 10,000 by default, 250,000 at most per request, paged with offset | runReport reference |
| Dimensions, metrics and periods | 9 dimensions per request, per Google's report guide. The test of November 14, 2026 also hit refusals at 11 metrics and 5 date ranges | Create a report, and the test |
| Realtime window | The last 30 minutes, up to 60 on 360, with at most 2 minute ranges per query | Realtime basics |
| How fresh the numbers are | Intraday data typically in 2 to 6 hours and daily data in 12 on standard properties. Processing can take 24 to 48 hours | Data freshness |
| Ryze AI tool inputs | getAiLandingPages: 200 rows at most. propertyId: 1 to 64 characters. runAdminRead path: up to 512 characters. AI-traffic dates: YYYY-MM-DD | Ryze AI tool definitions, November 14, 2026 |
| Gemini CLI wait per request | 600,000 ms (10 minutes) by default, set per server with timeout | Gemini CLI MCP servers |
Google's pages in the Source column were checked November 14, 2026.
Tested calls through the connector
These 8 GA4 calls went through the Ryze AI connector on November 14, 2026, sent from Claude Code over the default read-only connection to a standard property. Gemini talks to the same server, but none of them came from Gemini. Two asked for data; six were built to be refused so that Google's exact answers could be recorded. The property is real, so only field names and outcomes appear.
| What was asked | Tool | What came back |
|---|---|---|
| Every account and property the login can read | listAccountSummaries | Worked. accountSummaries, each holding propertySummaries with property, displayName, propertyType, parent and canEdit |
| Sessions for the day before the test, with returnPropertyQuota on | runRawReport | Worked. One row with metricHeaders, rowCount and metadata, plus a propertyQuota block whose totals equal the standard-property limits |
| A breakdown by the invented dimension trafficSauce | runRawReport | Refused with 400 INVALID_ARGUMENT. Google offered manualSource as the closest name |
| The misspelled metric sessionz | runRawReport | Refused with 400 INVALID_ARGUMENT. Google offered sessions |
| A report on a property ID that does not exist | runRawReport | Refused with status not_allowed, as an ordinary tool result |
| One report split by 10 dimensions | runRawReport | Refused with 400 INVALID_ARGUMENT |
| One report with 11 metrics | runRawReport | Refused with 400 INVALID_ARGUMENT |
| One report comparing 5 date ranges | runRawReport | Refused with 400 INVALID_ARGUMENT |
First 3 prompts to run
Each prompt below says what it asks for. Answers come from your own property, so this page shows no sample numbers.
1. Which AI assistants send visits
@Ryze AI List my GA4 properties, then show traffic from AI referrers by source engine for the last 30 days compared with the 30 days before.
Tools used: google_analytics__listAccountSummaries, google_analytics__getAiTrafficByEngine
What comes back: Your accessible properties, then AI engines with their sessions in each period and the change between them.
2. Pages that AI visitors land on
@Ryze AI List the top landing pages that receive AI-referred traffic, and show each AI referral source with its sessions and conversions.
Tools used: google_analytics__getAiLandingPages, google_analytics__getAIReferrals
What comes back: Up to 200 landing pages with AI-referred traffic, plus each AI referral source with sessions and conversions.
3. Compare two months by channel
@Ryze AI Run a GA4 report of sessions and key events by default channel group for last month and the month before, side by side.
Tools used: google_analytics__runRawReport
What comes back: One report with both date ranges by channel. Revenue shows as zero unless ecommerce tracking and purchase events are set up in GA4.
GA4 reports the visits that arrive from AI assistants. It does not measure whether an assistant mentions your brand.
10 jobs to hand to Gemini
Ten things to ask Gemini: nine matched to the Ryze AI tool that answers them, and one the connection cannot do. In the Gemini app, begin the prompt with @ and pick the Ryze AI app. Only listAccountSummaries and runRawReport were called in the test, from Claude Code, and no job was run from Gemini.
| Job | What to ask Gemini | Tool | Works on the default connection |
|---|---|---|---|
| Find property IDs | List every GA4 account and property I can read, with the ID of each property. | listAccountSummaries | Yes |
| Month against month by channel | Show sessions, key events and revenue by default channel group for last month next to the month before. | runRawReport | Yes |
| Landing page check | Top 20 landing pages by sessions in the last 28 days, with engagement rate and key event rate. | runRawReport | Yes |
| Revenue by source | Purchase revenue and purchases by session source and medium for this quarter. | runRawReport | Yes, with ecommerce tracking set up and no revenue restriction on the login |
| Channels across devices | Pivot sessions by default channel group against device category for the last 30 days. | runPivotReport | Yes |
| Visitors right now | Who is on the site in the last 30 minutes, by country and device? | runRealtimeReport | Yes, for the last 30 minutes |
| Property setup audit | List the key events, custom dimensions and audiences set up in this property. | runAdminRead | Yes, as a read |
| AI assistants by engine | Which AI assistants sent visits in the last 30 days, against the 30 days before? | getAiTrafficByEngine | Yes |
| AI visits per day | List daily visits from AI assistants such as ChatGPT and Perplexity for the last 8 weeks. | getAiTrafficDaily | Yes |
| Create a key event | Mark the sign_up event as a key event in this property. | None | No. No GA4 tool writes, and the Google scope is read-only |
4 ways to connect Gemini to Google Analytics
Custom apps in Gemini accept a server address only; Gemini CLI can also start a program on your computer. On the vendors' pages as read on November 14, 2026, four Google Analytics routes fit one of those surfaces or name Gemini. The Ryze AI connector is the main way: GA4 is approved once, one address serves web, phone and terminal, and nothing runs on your machine.
| Way | Gemini surface | Setup in Gemini | What it reaches in GA4 | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Web app, mobile app once added on the web, and Gemini CLI | A custom app with https://connector.get-ryze.ai/mcp under Settings, Connected Apps, or gemini mcp add --transport http with the same address. Sign-in in the browser | 9 read tools: core, pivot and realtime reports, Admin API reads, the account list and 4 AI-traffic reports. No writes | Paid Ads $89 per month with a 7-day free trial; the connector is free |
| analytics-mcp 1.1.0 (Google) | Gemini CLI. The Gemini app takes no local command | A pipx run analytics-mcp entry in ~/.gemini/settings.json. Needs Python 3.10 or later, a Google Cloud project with the Admin and Data APIs on, and Application Default Credentials. Google's docs page now calls Gemini CLI deprecated | 13 tools in the README. 10 reads: account list, property details, Google Ads links, annotations, custom dimensions and metrics, key events, and core, realtime, funnel and conversions reports. 3 writes (an annotation, a custom dimension, a key event), off unless started with --allow-write and the analytics.edit scope | No price stated. Open source under Apache-2.0 |
| Windsor.ai | Gemini is on Windsor's list of setup guides, surface not named | Add Google Analytics 4 as a data source in Windsor.ai, then follow its Gemini guide, which this page did not open | Read-only GA4 data, one of 350+ sources. 19 tools for the whole connector in Claude's directory | Forever Free (1 source, last 30 days) after a 30-day trial. Basic $23 per month |
| Coupler.io | Gemini is one of its AI integrations, surface not named. Its Custom MCP route needs a Bearer header, which only Gemini CLI documents | Build a GA4 data flow in Coupler.io, then pick the Gemini integration, or add its endpoint with a token as a Bearer header | Read-only answers from a synced copy of the data; Gemini never queries GA4 itself. Up to 10 metrics and 9 dimensions per flow | Free plan with manual refresh. Starter $32 per month after a 7-day trial |
Options that do not fit Gemini
- A built-in Google Analytics app in Gemini. Google's Connected Apps availability table, downloaded on November 14, 2026, had 90 app rows and none for Google Analytics. Google notes the table varies by location, language, device and Gemini app.
- analytics-mcp in HTTP mode (Google). Since 1.0.0 the package can also run as a server you host yourself, for example on Docker or Cloud Run, with OAuth 2.1 and a Google OAuth client you create. Its README names only Google ADK, an agent framework, for that mode.
- Google Analytics AI agent skills (Google). Instruction files that help a coding agent write API code, with no data connection. Named for Antigravity, Claude Code, Codex and Cursor.
- Ask Advisor chat method (Google). properties.chat in Data API v1alpha, a route for code with its own analytics.chatbot.read scope. Google names no assistant for it.
- Composio. 82 Google Analytics tools that read and write, with pages for Claude Code, ChatGPT, Cursor, Antigravity, Codex, VS Code and Grok, among others. Gemini is not listed.
- Zapier MCP. 6 Google Analytics 4 actions at 2 tasks per call. Its client list names Gemini Enterprise, which this guide does not cover, and neither the Gemini app nor Gemini CLI.
- surendranb/google-analytics-mcp. 8 read tools, MIT licence. Its README covers Claude Code, Claude Desktop, Cursor, Antigravity, VS Code extensions, Zed and Windsurf, not Gemini.
Which one to pick
Ryze AI is the best way to connect Gemini to Google Analytics when you want GA4 answers in the Gemini web app or on your phone without hosting anything, with one caveat: it only reads, it needs a Ryze AI plan or trial, and custom apps are open only to US adults on personal Google Accounts, in English. It also brings 4 tools built for visits from AI assistants. In Gemini CLI with a Google Cloud project, Google's analytics-mcp gives you Google's own code at no stated price, plus funnel and conversions reports and opt-in writes. Windsor.ai suits teams that already pull many marketing sources into one account; Coupler.io suits teams fine with answers from a scheduled copy of the data.
Sources: Google Analytics MCP docs, Google Analytics MCP server README, Google Analytics agent skills, Ask Advisor basics, Gemini Connected Apps availability table, Windsor MCP guides, Windsor.ai Google Analytics MCP, Windsor.ai pricing, Coupler.io Google Analytics MCP, Coupler.io pricing, Composio Google Analytics toolkit, Zapier MCP for Google Analytics 4, surendranb/google-analytics-mcp, Ryze AI Google Analytics guide. Checked November 14, 2026.
Google Analytics, Gemini and MCP: dates that matter
| Date | What happened |
|---|---|
| May 6, 2024 | The GA4 Data API introduced key events: keyEvents took over from the deprecated conversions metric. |
| June 25, 2025 | Google introduced Gemini CLI, with MCP support built in from the start. |
| July 30, 2025 | The Google Analytics team announced its MCP server in the Google Analytics API Notify group as a way to connect Analytics data to an LLM such as Gemini. |
| August 12, 2025 | Gemini CLI v0.1.19 brought the gemini mcp add, remove and list commands. |
| August 22, 2025 | analytics-mcp 0.1.0, the first release, appeared on PyPI. |
| June 18, 2026 | Gemini CLI stopped serving Google AI Pro and Ultra subscribers and free Code Assist for individuals users. |
| June 30, 2026 | Google wrote that custom MCP support was rolling out in Gemini Spark, now called tasks: the earliest dated Google mention of custom apps found. |
| October 22, 2026 | analytics-mcp 0.8.0 shipped its first write tool and the --allow-write flag. |
| November 3, 2026 | analytics-mcp 1.0.0 added a multi-user HTTP mode with OAuth 2.1 and left experimental status. |
| November 6, 2026 | analytics-mcp 1.1.0 added opt-in writes for custom dimensions and key events. Still the newest release on November 14, 2026. |
| November 10, 2026 | Google last updated the docs page of its Analytics MCP server, which marks Gemini CLI deprecated. Gemini CLI v0.68.0 was published the same day. |
Sources: GA4 Data API changelog, Google Analytics API Notify post, analytics-mcp on PyPI, analytics-mcp on GitHub, Google Analytics MCP docs, Gemini CLI announcement, Gemini CLI v0.1.19, Gemini CLI v0.68.0, Gemini CLI to Antigravity CLI, Gemini app update, June 2026. Checked November 14, 2026.
How this guide was tested
Two checks stand behind this page, both run outside Gemini: the connector address on November 13, 2026, and GA4 calls through the connector on November 14, 2026.
| What was run | What came back |
|---|---|
| The connector address without a sign-in (November 13) | HTTP 401 with a WWW-Authenticate header pointing to the sign-in details. Google's Gemini CLI page treats a 401 as the cue to look up OAuth and register. |
| The connector's two discovery files (November 13) | Both loaded, naming the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and the scopes mcp:read and mcp:write. |
| GA4 tool list, from Claude Code (November 14) | All 9 definitions loaded by exact name. None of the names contains a write verb. |
| Two GA4 reads (November 14) | listAccountSummaries and a one-day runRawReport both answered. The quota block of the report added up to the standard-property limits. |
| Six requests built to fail (November 14) | Five came back as 400 INVALID_ARGUMENT and one as not_allowed. The messages are in the errors table below. |
Not run: anything inside Gemini. No custom app was added, no gemini mcp add command was typed, no sign-in was finished and no tool was called from Gemini, so the Gemini steps follow Google's pages as they read on November 14, 2026. The GA4 calls came from Claude Code, which reaches the same server and the same 9 tools. runPivotReport, runRealtimeReport, runAdminRead and the four AI-traffic tools were loaded but not called, because they would return business data from a real property. No call went to Google's analytics-mcp and nothing was written.
Errors and fixes
Exact error messages from the test
Google returned these six messages in the test on November 14, 2026, copied from the responses with trailing spaces trimmed. Five arrived as Error 400 with Google's JSON error inside; the permission message came back as an ordinary tool result. If Gemini passes one on, the row says why and what to ask next.
| Message | Why it appeared | What to ask Gemini |
|---|---|---|
| Did you mean manualSource? Field trafficSauce is not a valid dimension. For a list of valid dimensions and metrics, see https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema | The Data API has no dimension by that name. The test sent it on purpose, and Google offered the nearest real one. | Ask for a real dimension such as sessionSource, or tell Gemini to take the name Google suggests. |
| Did you mean sessions? Field sessionz is not a valid metric. For a list of valid dimensions and metrics, see https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema | A misspelled metric, also sent on purpose. | Accept the suggested name. If you meant conversions, ask for keyEvents, its current name. |
| User does not have sufficient permissions for this property. To learn more about Property ID, see https://developers.google.com/analytics/devguides/reporting/data/v1/property-id. | The property ID is wrong, or the connected login has no role on that property. Google gives one answer for both cases. | Ask Gemini to run listAccountSummaries and use an ID from that list, or get the Viewer role from a property admin. |
| Requests are limited to 9 dimensions within a nested request. This request is for 10 dimensions. | One report can split the data by 9 dimensions at most. | Drop a breakdown, or ask for two smaller reports. |
| Requests are limited to 10 metrics within a nested request. This request is for 11 metrics. | The 11th metric in one report was refused. | Keep each report to 10 metrics, or have Gemini run two reports and put them side by side. |
| Requests are limited to 4 dateRanges. This request contains 5 dateRanges. | The fifth date range in one report was refused. | Compare up to 4 periods at a time, or use a date dimension across one longer range. |
Google's errors page lists two more answers that the test did not trigger: 429 RESOURCE_EXHAUSTED when a quota is used up, and 401 UNAUTHENTICATED when credentials are missing or invalid.
Source: GA4 Data API errors. Checked November 14, 2026.
Other problems
- Connected Apps is missing in Gemini
- Click Personal Intelligence, then Connected Apps. If it is still missing, check Google's requirements: age 18 or over, US, a personal Google Account and Keep Activity on. Custom apps can only be added in the web app.
- Gemini says the app is unavailable
- Google's help page says the feature is unavailable when Keep Activity is off. Turn it on and try again.
- The card shows Require setup
- No Property is saved for the workspace. Open the Google Analytics 4 card in Ryze AI, pick the account and property and click Save.
- The GA4 tools do not load in Gemini
- Gemini may keep the tool list from when you added the app. If GA4 was connected afterwards, remove the Ryze AI custom app in Connected Apps, add it again and start a new chat, as the Ryze AI help center advises for Claude and ChatGPT. This has not been tested in Gemini. In Gemini CLI, /mcp reload asks the server for its tools again.
- No properties are listed
- The connected Google login needs at least Viewer on a GA4 property. Only GA4 properties work, not Universal Analytics.
- Revenue is zero
- GA4 reports revenue only when ecommerce tracking and purchase events are set up in the property. A login with the No Revenue Metrics restriction also gets no revenue.
- Realtime numbers look short
- Realtime reports cover only the last 30 minutes.
- Gemini CLI shows no Ryze AI tools and no error
- Google's page says connection errors at startup are quiet. Run /mcp list, or gemini mcp list in the shell, to see the detail.
- Gemini CLI cannot sign in
- OAuth needs a local browser and a localhost callback. In a headless, SSH or container session use a Ryze AI API key header, or run /mcp auth ryze on a machine with a browser.
- Gemini CLI says it no longer serves your plan
- Since June 18, 2026 Google no longer serves Google AI Pro and Ultra users or free Gemini Code Assist for individuals users in Gemini CLI. Google points them to Antigravity CLI.
- Gemini says a subscription is required
- The GA4 tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI and retry.
Terms on this page
- Custom app
- Google's name for an MCP server linked to the Gemini app by its URL. Google also calls it a custom connected app.
- MCP
- The Model Context Protocol. Gemini uses it to call tools that a server such as the Ryze AI connector offers.
- Dynamic client registration
- A sign-in feature that lets Gemini create its own client record on a server. Google's help page asks you for credentials only when a server lacks it.
- Property ID
- The numeric ID of one GA4 property, found under Admin, Property Settings. Each Data API request must carry it, and Universal Analytics IDs do not work.
- Key event
- An event that measures an action that matters to your business, formerly called a conversion. The API metric is keyEvents.
- Default channel group
- Google's rule-based grouping of traffic sources, such as Direct, Organic Search, Paid Search and Referral. In the API it is sessionDefaultChannelGroup.
- Token
- What the Data API charges per report against a property's hourly and daily budget. Most requests cost 10 or fewer.
Sources: Gemini custom apps help, GA4 property ID, GA4 key events, GA4 default channel group, Data API quotas. Checked November 14, 2026.
Frequently asked questions
How do I connect Gemini to Google Analytics?
Connect Google Analytics 4 in a Ryze AI workspace: open Integrations, click Connect on the Google Analytics 4 card, sign in to Google and save the Property. Then in gemini.google.com open Settings, Connected Apps, Add a custom app, enter https://connector.get-ryze.ai/mcp, click Next, allow the workspace and type @ to pick Ryze AI in a prompt.
Does Gemini have a built-in Google Analytics connector?
Not one that Google lists: its Connected Apps availability table, downloaded on November 14, 2026, had no Google Analytics row, though Google says the table varies by location, language and device. Google publishes an open source Google Analytics MCP server that you run yourself, with Gemini CLI setup in its README. The Ryze AI connector gives Gemini a hosted URL instead.
Which Google Analytics connector should I use with Gemini?
Ryze AI is the best way to connect Gemini to Google Analytics 4 when you want a sign-in setup and AI-referral reports, but it is read only and the Gemini web app is limited to the US, personal accounts and English. Google's own server suits teams that host it in Google Cloud or want write tools.
Does Google Analytics have an MCP server?
Yes, Google publishes one: analytics-mcp, open source under Apache-2.0, at version 1.1.0 on November 14, 2026. It runs on your computer with your own Google Cloud project and credentials, and its README sets it up for Gemini CLI. The Ryze AI connector is a hosted MCP server with 9 GA4 read tools that can also be added to the Gemini web app as a custom app.
What is the Google Analytics MCP URL for Gemini?
For the Ryze AI connector it is https://connector.get-ryze.ai/mcp, the same address for every user, entered as a custom app in the Gemini web app or with gemini mcp add in Gemini CLI. Google's analytics-mcp has no fixed URL: Gemini CLI starts it as a local command, or you deploy it yourself in HTTP mode at an address of your own.
Which Gemini plan do I need?
Google's help page for custom apps names no plan. It requires you to be 18 or over and in the US, signed in with a personal Google Account (not a work or school account), with Keep Activity on. It is English only.
Can Gemini change anything in my Google Analytics?
No. All 9 Ryze AI GA4 tools are read tools, and the Admin API tool is GET only. The Google scope is analytics.readonly, so Gemini cannot create or edit properties, key events or audiences through this connector.
What GA4 access does the Google login need?
At least Viewer on a GA4 property. Keep every requested permission checked on the Google screen, then pick the Property in Ryze AI. Universal Analytics is not supported.
Can Gemini report on traffic coming from Gemini itself?
The AI traffic tools report visits from AI referrers such as ChatGPT and Perplexity by engine, by day, by landing page and by referral source. This page could not confirm that Gemini visits appear under a separate engine name, so check the engine list in your own results.
Does this work in Gemini CLI?
Yes. Run gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcp, then start Gemini CLI and sign in, or run /mcp auth ryze. Since June 18, 2026 Gemini CLI no longer serves Google AI Pro and Ultra users or free Code Assist for individuals users.
Does it work in the Gemini mobile app?
Custom apps can only be added in the Gemini web app. Once connected on the web, Google says the app also works in the Gemini mobile app.
Can I use more than one GA4 property or account?
Yes. Several Google logins can be connected to one workspace with Add one more account, each with its own Property. The starred one is the primary the agent uses by default, and other properties can be named in chat.
How much does it cost to connect Gemini to Google Analytics?
Connecting is free, but the GA4 tools need an active Ryze AI plan or trial. Paid Ads is $89 per month with a 7-day free trial, Agency is $279 per month, and SEO Starter is $129 per month with a 3-day free trial. Annual billing takes 30% off the first year.
How do I disconnect Google Analytics from Gemini?
Remove the Ryze AI app in Gemini under Settings, Connected Apps. To cut off GA4 itself, disconnect it in Ryze AI Integrations, or revoke access on your Google Account permissions page.