By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect ChatGPT to Google Analytics 4 is the Ryze AI connector. Connect GA4 in a Ryze AI workspace with your Google sign-in, then add https://connector.get-ryze.ai/mcp as a custom MCP server in ChatGPT Plugins using OAuth, and start a new conversation. Google publishes an Analytics MCP server of its own, but the pages for it do not name ChatGPT, and ChatGPT on the web takes a server address, so a hosted connector is the route that fits.
- In Ryze AI open Integrations, find Google Analytics 4 and click Connect
- Sign in to Google, approve access and save the Property for the workspace
- In ChatGPT open Plugins, add a custom MCP server and paste the URL
- Choose OAuth, sign in to Ryze AI, allow the workspace, then type @ in a new chat
ChatGPT to Google Analytics 4 at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP address that ChatGPT adds under Plugins as a custom MCP server |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | Two browser sign-ins and no key to paste: Google inside Ryze AI, then Ryze AI through OAuth from ChatGPT |
| GA4 tools | 9, and each one is a read tool |
| Can it change GA4 | No. The Google scope is analytics.readonly and the connector has no GA4 write tool |
| ChatGPT plan needed | Business or Enterprise/Edu for full MCP, per OpenAI's help article. Pro connects with read and fetch permissions. Free, Go and Plus are not mentioned there |
| Where it is added | ChatGPT on the web, by an admin or owner on Business. The mobile app cannot add it |
| GA4 access needed | The Viewer role or higher on a GA4 property |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free |
| Google's own MCP server | Open source. It starts as a local command, or you host its HTTP mode yourself. Google's docs page and README list seven assistants for it, and ChatGPT is not one of them |
| Last tested | Connector address on November 13, 2026. GA4 calls on November 14, 2026. No step was run inside ChatGPT |
Before you start
- A ChatGPT plan that allows custom MCP servers. OpenAI's help article says custom MCP server connections and full MCP support are available for ChatGPT Business and Enterprise/Edu customers on ChatGPT web. Pro users can connect custom MCP servers with read and fetch permissions. All 9 GA4 tools are read tools, but no Pro account was used for this page, so how a Pro account lists them is not confirmed here. The article does not mention Free, Go or Plus. On Business, only admins and owners can create and publish the plugin; members cannot add it themselves.
- Viewer access or higher on a GA4 property. The Google login you connect needs at least Viewer on the property. Ryze AI asks for the read-only Google Analytics scope (analytics.readonly) and 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; Agency ($279 per month) and SEO Starter ($129 per month, 3-day free trial) also include the GA4 tools. Connecting is free. Without a plan, the connector can only list workspaces and connect platforms.
How to connect ChatGPT to Google Analytics 4
Two steps happen in Ryze AI and Google, four in ChatGPT. The connector URL is the same for every user.
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.
Add a custom MCP server in ChatGPT
In ChatGPT web open Plugins (chatgpt.com/plugins). Developer Mode does not need to be turned on first, though account and workspace policies still apply. Select the plus button, then Add custom MCP server. Enter the name Ryze AI, optionally a description, and under Connection enter https://connector.get-ryze.ai/mcp as the Server URL.
Choose OAuth and create the plugin
Under authentication choose OAuth. Review the risk warning and select I understand and want to continue, then select Create as a plugin and review the tools ChatGPT discovered.
Sign in to Ryze AI and allow the workspace
Complete the Ryze AI sign-in when ChatGPT opens it, choose the workspace that holds your GA4 connection and click Allow connection. OpenAI's pages do not fix the moment the sign-in appears: some plugins ask during install, others the first time a tool is used. One connection can cover up to 20 workspaces.
Install the plugin and ask your first question
Install the plugin: open it under your personal plugins and select the plus button. Start a new conversation, type @ and select Ryze AI. Then ask: Which ChatGPT and Perplexity landing pages received sessions in the last 30 days, with conversions?
The Ryze AI help article for Google Analytics 4 covers the Google side of the connection, and the Ryze AI ChatGPT guide covers the ChatGPT side. OpenAI documents the flow in Connecting custom MCP servers in ChatGPT, read for this guide on November 14, 2026.
Older custom app flow
Some accounts still show the older custom app flow, which is how the Ryze AI help center describes it. The steps are:
- Open Settings, Apps, Advanced settings and turn on Developer mode.
- Click Create app.
- Set Name to Ryze AI, MCP server URL to https://connector.get-ryze.ai/mcp (keep Server URL, not Tunnel) and Authentication to OAuth.
- Tick I understand and want to continue, then click Create.
- Click Sign in with Ryze AI, log in, choose workspaces and click Allow connection.
- Start a new chat.
OpenAI's help article writes its older path differently. Admins and owners start at Workspace settings, Apps, Create, and authorized users at their own settings, Apps, Create. You give the endpoint, pick the authentication, select Scan Tools, finish the OAuth prompt while the scan runs, and only then select Create. No OpenAI page read on November 14, 2026 describes an Advanced settings screen or a Developer mode switch for MCP. If your screens do not match the list above, use the Plugins steps in the setup section.
Custom MCP servers cannot be connected on mobile, per OpenAI. Set the connection up on ChatGPT web.
Business and Enterprise/Edu publishing
On Business and Enterprise/Edu, an admin or owner connects and tests Ryze AI first. To publish it for the workspace, go to Admin Console, select the workspace, then Plugins, Manage Legacy Apps, Drafts and Publish, and review the safety warnings. Enterprise/Edu admins can use Configure Actions and Configure Access before publishing. Members then find published apps under Settings, Plugins.
What OpenAI's pages say about custom MCP servers in ChatGPT
| Topic | What OpenAI documents |
|---|---|
| Where a server is added | ChatGPT on the web: Plugins, the plus button, Add custom MCP server. Web chats have no config file for this |
| Transports | SSE and streaming HTTP. Under Connection the form offers Server URL or Tunnel, and it has no field for a local command |
| Authentication choices | OAuth, No authentication, or OAuth or no authentication. OpenAI's pages show no field for request headers, and ChatGPT cannot present a custom API key |
| How the OAuth sign-in runs | The authorization code flow with PKCE and S256. ChatGPT uses static client credentials if you enter them. Otherwise it presents a client ID metadata document or registers itself with the server |
| Tool approval | Write actions need confirmation by default, and a tool without the readOnlyHint annotation counts as a write action. The plugin permission settings change when ChatGPT asks |
| Plan | Full MCP on Business and Enterprise/Edu. Pro with read and fetch permissions. The help article says nothing about Free, Go or Plus |
| Pricing page | Lists a row named Developer mode (beta) for Plus, Pro, Business and Enterprise without saying what it covers or using the word MCP. It is no promise that a Plus account can add a server |
| Who may add a server | Business: admins and owners. Enterprise/Edu: admins, owners and members given the Create plugins with MCPs permission, which is off by default for Enterprise |
| Using it in a chat | Type @ and pick the installed plugin. The pick covers one message, so mention it again when a follow-up needs fresh data |
| Picking up new tools | Your own server: open it in Plugins and select Refresh. A server published to a workspace: a frozen snapshot stays until an admin refreshes and publishes the update |
| Where the connection is managed | Settings, Plugins, then the plugin: connected accounts with Reconnect and Disconnect. Workspace admins use Admin console, Plugins |
Sources: OpenAI help center, custom MCP servers, OpenAI guide, Add custom MCP server, OpenAI plugin authentication, OpenAI connect and test guide, ChatGPT docs on MCP, OpenAI app permissions, Plugins in ChatGPT, OpenAI app accounts, ChatGPT pricing. Checked November 14, 2026.
Claude and Cursor
The same URL works in other MCP clients. GA4 is connected once in Ryze AI, so nothing changes on the Google side.
Claude
Anthropic lists custom connectors on every Claude plan. Open Customize, Connectors, Add custom connector, paste the URL and click Connect. The Ryze AI guide for Claude covers it in full.
Cursor
Add the server to .cursor/mcp.json with the entry below.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Google permissions and scopes
The Google side of the connection is a standard Google OAuth sign-in. Three things decide what ChatGPT can see.
- Read-only scope
- Ryze AI requests analytics.readonly plus basic profile scopes. Nothing in the GA4 tools writes to Google Analytics, so ChatGPT cannot create or change properties, key events or audiences.
- Which properties
- The agent sees the accounts and properties the connected Google login can access, and the login needs at least Viewer. After connecting you pick a Property for the workspace; other properties stay reachable by naming them in chat.
- Which workspaces
- At the Ryze AI Allow connection screen you choose which workspaces ChatGPT may use. Use one workspace per business and a separate workspace per client.
Scopes requested
Ryze AI's help center describes the access like this. The Google consent screen is the source of truth for the exact list.
| Access | Google scope |
|---|---|
| Read GA4 reports and settings | analytics.readonly |
| Identify the signed-in Google user | openid, email, profile (basic profile scopes) |
Source: Ryze AI Google Analytics 4 integration.
The 4 Google scopes and 1 role behind the connection
The default connection rests on one Google consent screen. You create no API key, no service account, no Google Cloud project and no OAuth client of your own. It asks Google for four scopes, and the Google login behind it needs one role.
| Scope, role or setting | What Google lets it do | With Ryze AI |
|---|---|---|
| analytics.readonly | Viewing and downloading Google Analytics data. Google's report method and its account list method both accept it | All 9 GA4 tools work through it |
| openid, email, profile | Tying the sign-in to a Google identity and seeing the account's primary email address and basic personal info | Tells Ryze AI which Google login was connected |
| Viewer role on the property | Seeing settings and data, and changing what a report shows, for example by adding a comparison | The minimum role the connected Google login needs |
| Data restrictions on a role | A role can be set to hide cost metrics or revenue metrics, in the interface and in API calls alike | A login restricted this way gets no cost or revenue figures in ChatGPT either |
Not requested: analytics.edit, the scope for editing Google Analytics management entities, and analytics.chatbot.read, the scope for Google's Ask Advisor chat method. The Marketer and Editor roles are not needed. So ChatGPT cannot create or change a key event, an audience or a property setting through this connection.
Sources: Google OAuth 2.0 scopes, Google Analytics roles and data restrictions. Checked November 14, 2026.
Removing access
To remove access, disconnect Google Analytics 4 on its card in Ryze AI, or revoke Ryze AI under your Google Account's third-party access. In ChatGPT, open Settings, Plugins, select Ryze AI and choose Disconnect next to the connected account, or delete the Ryze AI plugin (or app) you created. Two OpenAI pages describe differently whether uninstalling a plugin also ends its connection, so Disconnect is the step to rely on.
What ChatGPT can do in Google Analytics 4
The Ryze AI connector exposes 9 Google Analytics 4 tools. All 9 are read tools.
| Tool | Type | What it does |
|---|---|---|
| google_analytics__listAccountSummaries | Read | Lists the GA4 accounts and properties the connected Google login can access, so the agent can find property IDs. |
| google_analytics__runRawReport | Read | Runs a GA4 Data API runReport with chosen dimensions, metrics, named date ranges, filters and ordering, and pages through the results. |
| google_analytics__runPivotReport | Read | Runs a GA4 Data API pivot-table report. |
| google_analytics__runRealtimeReport | Read | Runs a GA4 Data API 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 and cannot write. |
| google_analytics__getAiTrafficByEngine | Read | Returns traffic from AI referrers grouped by source engine and compared with a prior period, for one GA4 property. |
| google_analytics__getAiTrafficDaily | Read | Returns daily traffic from AI referrers such as ChatGPT and Perplexity for one GA4 property. |
| 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. |
All 9 tools only read, so the connector does not change anything in GA4. ChatGPT may still ask for confirmation based on app permissions and context. For a custom MCP server, OpenAI says write actions need confirmation by default and that a tool is treated as read-only when it carries the readOnlyHint annotation. The standard permission settings offer Always ask, Allow read actions and Allow low-risk actions. Personal accounts choose under Settings, Plugins, Permissions, and a workspace admin sets the default for a workspace. On Pro, OpenAI limits custom MCP servers to read and fetch permissions.
GA4 and ChatGPT limits in numbers
| Limit | Detail |
|---|---|
| Tokens per property | 200,000 a day and 40,000 an hour on a standard property. Analytics 360 gets ten times both. |
| Tokens per Google Cloud project | 14,000 per property per hour on standard, 140,000 on 360. |
| Requests at the same time | 10 per property on standard, 50 on 360. |
| Token cost of one report | Google says most requests charge 10 tokens or fewer. Extra rows, dimensions, metrics, filters and long date ranges raise it. |
| When a budget reaches zero | Requests to that property fail with 429 RESOURCE_EXHAUSTED. Daily budgets refill at midnight Pacific time, hourly ones within the hour. |
| Rows in one report | 10,000 when no limit is given and never more than 250,000 per request. |
| Dimensions in one report | 9, per Google's guide to creating a report. |
| Metrics and date ranges in one report | 10 metrics and 4 date ranges. Both come from the API's answers in the test on November 14, 2026; Google's reference pages do not print them. |
| Realtime reports | The last 30 minutes on a standard property and up to 60 on 360, with a token budget of their own. |
| Admin API | 1,200 requests per minute and 600 per minute per user. |
| Freshness of the data | On a standard property, typically 2 to 6 hours for intraday data and 12 hours for daily data, per Google. |
| Ryze AI tool inputs | getAiLandingPages returns 200 rows at most. runRawReport returns 10,000 rows unless told otherwise. |
| ChatGPT side | OpenAI gives no number for tools per server or for custom servers per account. |
Sources: Data API quotas, runReport reference, Create a report, Realtime reports, Admin API quotas, Google Analytics data freshness, ChatGPT pricing docs. Checked November 14, 2026.
The 8 GA4 calls made in the test
Eight Google Analytics 4 calls went through the Ryze AI connector on November 14, 2026, over the default read-only connection to a standard property. Two were ordinary reads and six were sent wrong on purpose to collect Google's error messages. The calls came from Claude Code, which reaches the same server and the same 9 tools. The property belongs to a real account, so none of its figures appear on this page.
| Call | What was sent | What came back |
|---|---|---|
| 1. listAccountSummaries | The workspace and nothing else | Worked. Account summaries, each with its property summaries: property, display name, property type, parent and an edit flag |
| 2. runRawReport | One day, one metric (sessions), with the property quota requested | Worked. One row, a row count, the property's currency code and time zone, and a quota block whose totals equal Google's limits for a standard property |
| 3. runRawReport | A dimension name that does not exist | Refused with HTTP 400, INVALID_ARGUMENT, and a suggested name |
| 4. runRawReport | A metric name that does not exist | Refused the same way |
| 5. runRawReport | A property ID that does not exist | Refused with the status not_allowed, delivered as a normal tool result |
| 6. runRawReport | 10 dimensions | Refused with HTTP 400. The cap is 9 |
| 7. runRawReport | 5 date ranges | Refused with HTTP 400. The cap is 4 |
| 8. runRawReport | 11 metrics | Refused with HTTP 400. The cap is 10 |
First 3 prompts to run
GA4 reports visits that arrive from AI assistants. It does not measure whether an assistant mentions your brand. Revenue shows as zero unless ecommerce tracking and purchase events are set up in GA4, and GA4 and Shopify numbers will not match exactly because they attribute sessions and conversions differently.
1. Which AI engines send visits
For my GA4 property, show traffic from AI referrers by source engine for the last 30 days compared with the prior 30 days.
Tools used: listAccountSummaries, getAiTrafficByEngine
What comes back: A table of AI engines with their sessions in each period and the change between them, based on your own property.
2. Landing pages that AI visitors reach
List the top landing pages that receive AI-referred traffic, and show the AI referral sources with their sessions and conversions.
Tools used: getAiLandingPages, getAIReferrals
What comes back: Up to 200 landing pages with AI-referred traffic, plus each AI referral source with sessions and conversions.
3. Channel conversions across date ranges
Run a GA4 report of sessions, key events and revenue by default channel group for last month and the month before, and list which key events are configured in the property.
Tools used: runRawReport, runAdminRead
What comes back: One report with both date ranges side by side by channel, and the list of key events read from the GA4 Admin API.
Each answer comes from your own property, so this page describes what comes back instead of showing sample numbers.
9 jobs to give ChatGPT
Nine jobs to give ChatGPT, each matched to the tool behind it. Type @ and pick Ryze AI in the message that needs data. The two tools in the first three rows were called in the test. The other tools were loaded and not called.
| Job | Ask ChatGPT | Tool | Works on the default connection |
|---|---|---|---|
| Property list | Which GA4 accounts and properties can this Google login read? Give me the property IDs. | listAccountSummaries | Yes |
| Channel comparison | Compare sessions, key events and revenue by default channel group for last month and the month before. | runRawReport | Yes, within 4 date ranges, 9 dimensions and 10 metrics per report |
| Revenue by source | Break purchase revenue and purchases down by source and medium. | runRawReport | Yes, once ecommerce tracking and purchase events exist in GA4. A login with the No Revenue Metrics restriction sees no revenue |
| Device pivot | Build a pivot of sessions by channel across device categories. | runPivotReport | Yes |
| Live visitors | Who is on the site right now, by country and device? | runRealtimeReport | Yes, for the last 30 minutes |
| Setup audit | List the key events, custom dimensions and audiences set up in this property. | runAdminRead | Yes, as a read |
| AI engines | Which AI assistants sent visits in the last 30 days, against the 30 days before? | getAiTrafficByEngine | Yes |
| AI trend and pages | Show the daily trend of visits from AI assistants, then the landing pages they arrive on. | getAiTrafficDaily, getAiLandingPages | Yes. The landing page list stops at 200 rows |
| New key event | Create a key event for the sign-up form. | None | No. There is no GA4 write tool and the scope is analytics.readonly |
5 ways to connect ChatGPT to Google Analytics 4
ChatGPT on the web adds an MCP server by its public address or installs a plugin. It does not start a server from a command on your computer. Five ways to reach Google Analytics 4 fit that shape. This guide uses the first one, the Ryze AI connector, as the main way: you approve Google once, paste one address, and get four reports on AI-referred traffic beside the standard GA4 reports. The other four were read on their own pages on November 14, 2026.
| Way | Runs where | Setup in ChatGPT | What it reaches in GA4 | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI at one public address, with nothing to host on your side | GA4 sign-in inside Ryze AI, then Plugins, Add custom MCP server, the address https://connector.get-ryze.ai/mcp and OAuth | 9 read tools: reports, pivot reports, realtime, Admin API reads, account summaries and 4 reports on AI-referred traffic. No write tool | Paid Ads is $89 per month with a 7-day free trial |
| Composio | Hosted by Composio | Install the Composio plugin from Settings, Plugins, or add a server named Composio at https://connect.composio.dev/mcp and authenticate. Google Analytics connects through Composio's own Google OAuth app | 82 Google Analytics tools that read and write, among them creating an audience | Free up to 10,000 tool calls a month. Standard is $18 per seat per month |
| Zapier MCP | Hosted by Zapier | On Zapier, generate your MCP URL and choose the actions, as its Google Analytics 4 page describes. In ChatGPT a server URL goes in under Plugins, Add custom MCP server, followed by the Zapier sign-in. Zapier names ChatGPT among its popular MCP clients | 6 Google Analytics 4 actions, such as running a report and creating a conversion event | Open to every Zapier account. One tool call uses 2 tasks, and the Free plan has 100 tasks a month |
| Windsor.ai | Hosted by Windsor.ai | Connect Google Analytics 4 as a data source in Windsor.ai, then install the Windsor plugin in ChatGPT | Read access to GA4 data. Windsor's guide calls it read-only | A free plan with 1 data source and 1 account that reaches the past 30 days. Basic is $23 per month |
| Coupler.io | Hosted by Coupler.io. ChatGPT queries a copy of the GA4 data that Coupler.io syncs from your property | Build a GA4 data flow in Coupler.io, then connect its ChatGPT integration. Its other route, a custom endpoint with a bearer token header, does not suit ChatGPT: OpenAI's pages show no header field in the form | Read only, with up to 10 metrics and 9 dimensions in a data flow | Free with 1 data source and manual refresh. Starter is $32 per month |
Google's own options and one open-source server that do not fit ChatGPT
- Google's Analytics MCP server, run as a local command. Open source, at version 1.1.0 since November 6, 2026. The assistant starts it on your computer with pipx or uvx, using Application Default Credentials and a Google Cloud project with the Admin API and the Data API enabled. Google's docs page names Antigravity CLI, Antigravity IDE, Claude Desktop, Claude Code and Cursor for it, and the README adds Gemini CLI and Gemini Code Assist. ChatGPT is on neither list, and ChatGPT on the web does not run local commands. The docs page lists 9 read tools, covering account and property details, Google Ads links, annotations, custom definitions, and core, realtime, funnel and conversions reports. The server reads by default: its three write tools stay off without the --allow-write flag and the analytics.edit scope.
- The same server in HTTP mode. Since version 1.0.0 it can run with an HTTP transport on hosting you provide, such as Docker or Cloud Run, with a Google OAuth web client that you create. That would give ChatGPT the public address it requires. The README names one client for this mode, Google ADK, an agent framework. Google does not say whether ChatGPT accepts the server, and it was not tried for this page.
- Google Analytics AI agent skills. Instruction files that help a coding agent write code against the Data API and the Admin API. Google names Antigravity, Claude Code, Codex and Cursor for them. They carry no data connection.
- The Ask Advisor chat method. A Data API method, added in v1alpha on September 14, 2026, that sends a question to the assistant inside Google Analytics. It is made for code that calls the API, and Google's page names no chat assistant for it.
- surendranb/google-analytics-mcp. A free open-source server with 8 read tools and 244 GitHub stars on November 14, 2026. It is a local process started with uvx or npx, and its README names Claude Code, Cursor, Google Antigravity, Claude Desktop, VS Code extensions, Zed and Windsurf.
Which one to pick
Ryze AI is the best way to connect ChatGPT to Google Analytics 4 when you want reports on AI-referred traffic next to the standard GA4 reports, with a caveat: it only reads, and ChatGPT needs a plan that allows custom MCP servers. Choose Composio or Zapier when ChatGPT also has to change GA4, for example to create an audience or a conversion event, or when your team already runs one of them for other apps. Windsor.ai and Coupler.io suit teams that already move their marketing data through those services. Google's own server is a fit if you already run Google Cloud projects and want to host it yourself. For ChatGPT that means its HTTP mode on your own hosting, a route Google's pages do not describe for ChatGPT.
Sources: Google Analytics MCP server docs, google-analytics-mcp on GitHub, Google Analytics agent skills, Ask Advisor chat method, Composio Google Analytics for ChatGPT, Composio pricing, Zapier MCP for Google Analytics 4, Zapier MCP quickstart, Zapier pricing, Windsor.ai GA4 MCP, Windsor.ai pricing, Coupler.io Google Analytics MCP, Coupler.io pricing, surendranb/google-analytics-mcp, OpenAI guide, Add custom MCP server, OpenAI custom MCP servers, Ryze AI Google Analytics 4 integration. Checked November 14, 2026.
ChatGPT, Google Analytics and MCP: dates that matter
| Date | What happened |
|---|---|
| June 4, 2025 | The earliest entry for custom connectors through the Model Context Protocol in ChatGPT's release notes. They needed a remote MCP server and worked in deep research only. |
| July 30, 2025 | The Google Analytics team announced the Google Analytics MCP server in its API Notify group. |
| October 17, 2025 | OpenAI began rolling out full MCP support with developer mode, in beta, to ChatGPT Business, Enterprise and Edu. |
| July 9, 2026 | ChatGPT's Plugin Directory replaced the App Directory. Existing app connections were left as they were. |
| September 14, 2026 | Google's Data API v1alpha gained the Ask Advisor chat method, properties.chat. |
| October 1, 2026 | Owners and admins on ChatGPT Business and Enterprise could manage plugins in Admin console, with Manage Legacy Apps leading to the older Apps page. |
| November 3, 2026 | analytics-mcp 1.0.0 added a Streamable HTTP transport and OAuth 2.1 support, and Google's server left experimental status. |
| November 6, 2026 | analytics-mcp 1.1.0 added Cloud Run deployment docs and opt-in Admin API write tools. It was still the newest version on November 14, 2026. |
| November 10, 2026 | Google last updated its docs page for the server. The page lists Antigravity CLI and IDE, Claude Desktop, Claude Code and Cursor, and calls Gemini CLI deprecated. |
Sources: ChatGPT release notes, ChatGPT Business release notes, ChatGPT Enterprise and Edu release notes, Google Analytics API Notify post, analytics-mcp on PyPI, google-analytics-mcp on GitHub, Data API changelog, Google Analytics MCP server docs. Checked November 14, 2026.
How this guide was tested
The connector address was checked on November 13, 2026, and its Google Analytics 4 tools on November 14, 2026. Nothing was run inside ChatGPT.
| Check | Result |
|---|---|
| The connector address, with no sign-in (November 13, 2026) | Asked without credentials, https://connector.get-ryze.ai/mcp answered HTTP 401 and sent a WWW-Authenticate header pointing to where the sign-in details live. OpenAI's authentication guide says that one header is enough for ChatGPT to find them. |
| The sign-in details (November 13, 2026) | The connector's two discovery files both opened. Between them they list an authorize, a token and a register endpoint, two grants (authorization code and refresh token), PKCE with the S256 method, and the scopes mcp:read and mcp:write. |
| The GA4 tool list (November 14, 2026) | All 9 tool names were loaded from the connector by exact name and each one returned a definition. None of the names contains a write verb. |
| Two reads (November 14, 2026) | listAccountSummaries and a one-day, one-metric runRawReport both worked. Calls 1 and 2 in the calls table above show what came back. |
| Six reports sent wrong on purpose (November 14, 2026) | A dimension and a metric that do not exist, a property ID that does not exist, 10 dimensions, 5 date ranges and 11 metrics. All six were refused. Their messages are in the errors table below. |
Not run for this page: every step inside ChatGPT. No server was added there, no sign-in was completed and no tool was called from ChatGPT, on any plan. Those steps follow OpenAI's pages as they read on November 14, 2026. The signed-in client for the GA4 calls was Claude Code. runPivotReport, runRealtimeReport, runAdminRead and the four AI-traffic tools were loaded and not called, because they would return business data from a real account. A report asking for more than 250,000 rows was not tried. No signed-in call went to Google's own MCP server, and no write was made, since the connector has no GA4 write tool.
GA4 errors and fixes
Exact Google Analytics error messages from the test
These six messages came back in the test on November 14, 2026. They are copied from the responses, with line breaks and extra spaces removed. Five reached the assistant as Error 400 with Google's code, message and status inside. The permission message came back as a normal tool result with a status and a message. In ChatGPT you can expand a tool call to read its full input and output.
| Message | What it means | What to do in ChatGPT |
|---|---|---|
| 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 report asked for a dimension the Data API does not have. The test sent a made-up name, and Google replied with the closest real one. Code: 400 INVALID_ARGUMENT. | Ask again with a real dimension such as sessionSource, or tell ChatGPT to use the name Google suggested. |
| 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 metric that does not exist, also sent on purpose. Same code. | Take the suggested metric. If ChatGPT asked for conversions, point it to keyEvents, because Google deprecated the older 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. | Either the property ID does not exist or the connected Google login has no role on that property. Google gives one answer for both. In the test it came back with the status not_allowed. | Have ChatGPT run listAccountSummaries and pick an ID from that list, or ask a property admin for the Viewer role. |
| Requests are limited to 9 dimensions within a nested request. This request is for 10 dimensions. | A single report can be broken down by 9 dimensions at most. | Ask for fewer breakdowns, or let ChatGPT split the question into two reports. |
| Requests are limited to 10 metrics within a nested request. This request is for 11 metrics. | A single report holds 10 metrics at most. | Have ChatGPT run two reports and join them in its answer. |
| Requests are limited to 4 dateRanges. This request contains 5 dateRanges. | A single report compares 4 date ranges at most. | Compare up to 4 periods at a time, or ask for one longer range broken down by date. |
Two more codes are on Google's errors page and were not triggered in the test: 429 RESOURCE_EXHAUSTED, when a quota budget is used up, and 401 UNAUTHENTICATED, when a request arrives without valid credentials. Source: Data API errors. Checked November 14, 2026.
Setup and data problems
- The plugin option is missing in ChatGPT
- Custom MCP servers are available on Business and Enterprise/Edu, and Pro with read and fetch only. On Business, only admins and owners can create the plugin. Ask your admin, or check your plan.
- 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.
- GA4 tools do not appear in ChatGPT
- ChatGPT keeps the tool list from when you added the connector. If GA4 was connected afterwards, open the server in Plugins and select Refresh, or remove the app, install it again and start a new chat, as the Ryze AI help center advises. On Business or Enterprise/Edu, an admin must refresh and publish an update.
- 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.
- Realtime numbers look short
- Realtime reports cover only the last 30 minutes.
- ChatGPT says a subscription is required
- The GA4 tools need an active Ryze AI plan or free trial. Start the trial, then retry.
- Reports fail with a quota error
- Google limits Data API usage per property. For a standard property Google lists 200,000 tokens per day, 40,000 per hour and 10 concurrent requests. Narrow the date range or dimensions and try again.
- ChatGPT on mobile cannot add the server
- OpenAI does not allow custom MCP servers on mobile. Use ChatGPT web.
Terms on this page
- MCP
- Short for Model Context Protocol. It is the protocol ChatGPT uses to reach the tools of a server such as the Ryze AI connector.
- Custom MCP server
- OpenAI's name for a server you add to ChatGPT by its address. Once added it becomes a plugin that you install. Older OpenAI pages call the same connection an app or a connector.
- Property ID
- The number of the Google Analytics property a report is produced for. Every Data API request names it, and Google Analytics shows it under Admin, Property Settings.
- Key event
- An event that marks an action that matters to your business. Google used to call it a conversion, and the API metric is now keyEvents.
- Token
- The unit Google charges for each Data API report. A standard property has 200,000 of them a day.
- Viewer role
- The lowest Google Analytics role that can see data. The Google login behind the Ryze AI connection needs at least this role.
Sources: OpenAI guide, Add custom MCP server, Google on property IDs, Google on key events, Data API quotas, Google Analytics roles. Checked November 14, 2026.
Frequently asked questions
How do I connect ChatGPT to Google Analytics?
Connect Google Analytics 4 in a Ryze AI workspace: open Integrations, click Connect on Google Analytics 4, sign in to Google and save the Property. Then in ChatGPT open Plugins, add a custom MCP server named Ryze AI with the URL https://connector.get-ryze.ai/mcp, choose OAuth, sign in, allow the workspace and start a new conversation.
Is there a Google Analytics MCP server for ChatGPT?
Yes. The Ryze AI connector at https://connector.get-ryze.ai/mcp is a hosted MCP server with 9 read tools for Google Analytics 4, and ChatGPT adds it by address under Plugins. Composio, Zapier, Windsor.ai and Coupler.io also run hosted Google Analytics connections, and each names ChatGPT among the assistants it works with.
Is there an official ChatGPT Google Analytics connector?
Google's pages for its Analytics MCP server do not name ChatGPT. That server is open source and you run it yourself; its docs page and README name Antigravity, Claude Desktop, Claude Code, Cursor, Gemini CLI and Gemini Code Assist. The ChatGPT plugin directory was not browsed for this page, so nothing is claimed about its listings. The Ryze AI connector gives ChatGPT a hosted URL instead.
Does Google Analytics have an official MCP server?
Yes. Google publishes an open-source server called analytics-mcp, first released on August 22, 2025 and at version 1.1.0 since November 6, 2026. It runs on your own computer, or on your own hosting in HTTP mode, with Google credentials that you set up. It reads by default and has three opt-in write tools.
What is the Google Analytics MCP URL for ChatGPT?
With the Ryze AI connector the address is https://connector.get-ryze.ai/mcp, the same for every user, entered as the Server URL with OAuth as the authentication. Google's analytics-mcp server has no public address of its own: it starts as a local command, or you host its HTTP mode yourself.
Which ChatGPT plan do I need?
OpenAI says custom MCP server connections and full MCP support are available for ChatGPT Business and Enterprise/Edu on web. Pro users can connect custom MCP servers with read and fetch permissions only. OpenAI's article does not mention Free, Go or Plus.
Can ChatGPT 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 ChatGPT cannot create or edit properties, key events or audiences.
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.
Which should I use, Google's server or the Ryze AI connector?
Ryze AI is the best way to connect ChatGPT to Google Analytics 4 for AI-referral reports, but it is read-only and needs a ChatGPT plan that allows custom MCP servers. Google's own server suits teams that want to host it themselves in Google Cloud. Its pages name no setup for ChatGPT.
Which MCP server connects Google Analytics, Google Ads and Search Console to ChatGPT?
The Ryze AI connector does. One address, https://connector.get-ryze.ai/mcp, serves the Google Analytics 4 tools together with Google Ads and Google Search Console tools, for the platforms connected in the workspaces you allowed.
Can ChatGPT report on traffic coming from ChatGPT itself?
Yes. getAiTrafficByEngine, getAiTrafficDaily, getAiLandingPages and getAIReferrals report visits from AI referrers such as ChatGPT and Perplexity. GA4 shows the visits that arrive, not whether an assistant mentions your brand.
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. For separate clients, use one Ryze AI workspace per client.
Does it work in the ChatGPT mobile app?
You cannot add the server on mobile, because OpenAI does not support custom MCP servers there. Set it up on ChatGPT web. OpenAI's pages do not say whether a plugin made from a custom MCP server can then be used in the mobile app.
Why do the GA4 tools not show up in ChatGPT?
ChatGPT keeps the tool list from when the server was added. Open the server in Plugins and select Refresh, or remove the app, install it again and start a new chat. On Business and Enterprise/Edu an admin must refresh and publish an update.
How much does it cost?
Connecting costs nothing, but the GA4 tools need an active Ryze AI plan or free 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 ChatGPT?
In ChatGPT open Settings, Plugins, select Ryze AI and choose Disconnect, or delete the Ryze AI plugin or app. Then disconnect Google Analytics 4 on its card in Ryze AI. You can also revoke Ryze AI in your Google Account.