By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Cursor to Google Analytics, connect GA4 in Ryze AI with a Google login that has at least Viewer access, pick the property, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or a url entry in mcp.json and sign in when Cursor asks.
- In Ryze AI open Integrations, click Connect on Google Analytics 4 and approve the Google screen
- Pick the Property for your workspace and click Save
- In Cursor add the Ryze AI server (Add to Cursor link or mcp.json) and finish the sign-in
- Start a new Cursor chat, approve the tool call and ask about your GA4 traffic
Before you start
- A Cursor install. Cursor's MCP documentation names no plan for using MCP servers. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration, so a blocked server needs an admin to allow it.
- A Google login with GA4 access. The login needs at least Viewer access on a GA4 property. Universal Analytics is not supported, only GA4 properties. Keep every permission checked on the Google screen.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; the GA4 tools also work on SEO Starter ($129 per month, 3-day free trial) and Agency ($279 per month). Adding the connector is free, but the GA4 tools need an active plan or trial.
How to connect Cursor to Google Analytics
Two steps happen in Google and Ryze AI, two in Cursor, and one when you ask. 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 with every requested permission checked.
Pick the 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 the Ryze AI server to Cursor
Either use the Add to Cursor link on this page or the Ryze AI developers page, which opens a cursor:// install link for a server named ryze at https://connector.get-ryze.ai/mcp, or create ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) with the url entry shown below.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Sign in from Cursor
Confirm the install in Cursor. Cursor runs OAuth with PKCE and dynamic client registration, so there is no client ID or secret to enter. Sign in on the Ryze AI page and click Allow connection. You can manage or toggle the server from the Customize page in the sidebar.
Ask your first question in Cursor
Start a new chat in Cursor, approve the tool call when Cursor asks, and try: List the GA4 properties I can access, then show sessions by channel for the last 28 days.
The Ryze AI help center page for Google Analytics covers the Google Analytics side of the connection. Cursor does not have its own Ryze AI help page; the Ryze AI developers page has the Add to Cursor link and the matching config.
Sources: Cursor MCP documentation, Ryze AI Google Analytics guide. Checked November 14, 2026.
mcp.json, API key and Cloud Agents
mcp.json
Save this as ~/.cursor/mcp.json for every project or .cursor/mcp.json for one project. Cursor accepts remote servers through the url field and handles the OAuth sign-in itself.
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Cursor supports stdio, SSE and Streamable HTTP transports. For OAuth it reads the server's protected resource metadata (RFC 9728) and registers as a public client through dynamic client registration. After sign-in, manage or toggle the server from the Customize page in the sidebar.
mcp.json with a Ryze AI API key
If you prefer a key to the browser sign-in, add a headers entry and set RYZE_API_KEY in your environment to the rk_live_ key from Ryze AI under Workspace Settings > Profile > API keys. Keep the key out of files you commit.
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:RYZE_API_KEY}"
}
}
}
}Cloud Agents
Cursor Cloud Agents keep their own MCP sign-ins on Cursor's servers, separate from the sign-in on your desktop. If a Cloud Agent needs GA4 data, connect the Ryze AI server for it as well.
Claude and ChatGPT
The same URL works in other MCP clients. Google Analytics is connected once in Ryze AI, so nothing changes on the Google Analytics side.
Claude
Add https://connector.get-ryze.ai/mcp as a custom connector under Customize > Connectors, pick the workspace and start a new chat. If the connector was added before GA4 was connected, remove and re-add it, then start a new chat.
ChatGPT
Add the same URL as an app under Settings > Apps, pick the workspace and start a new chat. Re-add the app if GA4 was connected in Ryze AI afterwards, so the tool list refreshes.
Google Analytics access and scopes
Two sign-ins are involved: Google for GA4 access and Ryze AI for the connector. Three things decide what Cursor can reach.
- Which property
- You pick a Property for the workspace after connecting. The Google login must have at least Viewer access on it. Several Google logins can be connected to one workspace with Add one more account, each with its own Property, and one is the primary (set with the star).
- What Cursor can change
- Nothing in GA4. The connector requests the read-only Google Analytics scope, and all 9 GA4 tools are read tools, so Cursor cannot create or edit properties, key events or audiences.
- What Cursor asks first
- Cursor asks for approval before using MCP tools by default and follows the same Run Modes as terminal commands, so each tool call waits for your click unless you allowlist the tool.
The key scopes
Ryze AI requests one Google Analytics scope plus basic profile scopes. Keep every requested permission checked on the Google screen.
| Action in Ryze AI | Google Analytics access |
|---|---|
| Run reports, pivot reports and realtime reports | analytics.readonly, with Viewer access on the property |
| Read key events, custom dimensions and audiences | analytics.readonly (Admin API read, GET only) |
| List accounts and properties | analytics.readonly on the connected Google login |
| Create, edit or delete GA4 settings | Not available: the connector has no GA4 write tools |
Removing access
To remove access, disconnect Google Analytics 4 on its card in Ryze AI or remove Ryze AI from your Google Account's third-party access page. In Cursor, toggle the ryze server off from Customize or delete its entry from mcp.json.
What Cursor can do in Google Analytics
The Ryze AI connector exposes 9 GA4 tools, all read-only. Four of them report on traffic from AI assistants.
| Tool | Type | What it does |
|---|---|---|
| google_analytics__runRawReport | Read | Runs a GA4 Data API report 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__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. |
| google_analytics__runAdminRead | Read | Reads a GA4 Admin API resource such as key events, custom dimensions or audiences. It is GET only. |
| google_analytics__listAccountSummaries | Read | Lists the GA4 accounts and properties the connected Google login can access, which gives Cursor the property IDs. |
Realtime reports cover only the last 30 minutes. Revenue shows as zero unless ecommerce tracking and purchase events are set up in GA4. The tools work only while the Ryze AI workspace has an active plan or free trial, and GA4 numbers can differ from Shopify numbers because the two attribute sessions and conversions differently.
Cursor asks before it runs an MCP tool by default. Keep that default if you want to review each call, or allowlist the read tools to skip the prompt. Separately, the Ryze AI chat has its own Tool approvals picker that starts on Skip all approvals; since every GA4 tool is read-only, no approval setting can change anything in GA4. Scheduled tasks run without an approval step.
First 3 prompts to run
1. Find the property and compare channels
List the GA4 properties I can access, then show sessions, key events and revenue by default channel group for the last 28 days against the 28 days before.
Tools used: google_analytics__listAccountSummaries, google_analytics__runRawReport
What comes back: A list of properties, then a table of channels with two date ranges side by side in Cursor. Revenue is zero if purchase events are not set up in GA4.
2. See visits from AI assistants
Show traffic from AI assistants by engine against the prior period, and list the top landing pages that receive it.
Tools used: google_analytics__getAiTrafficByEngine, google_analytics__getAiLandingPages
What comes back: Sessions per AI engine such as ChatGPT or Perplexity with a comparison period, then up to 200 landing pages. GA4 reports visits that arrive from assistants, not whether they mention your brand.
3. Check what is live right now
Run a realtime report and show active users by country and by page for the last 30 minutes.
Tools used: google_analytics__runRealtimeReport
What comes back: A short table of current activity from your own property. Nothing in GA4 is changed.
Each answer comes from your own GA4 property, so this page describes what comes back instead of showing sample numbers. Replace the names in the prompts with ones from your property.
Ryze AI vs Google's own Analytics MCP server
Google publishes an open-source Analytics MCP server that runs on your machine. The two options suit different setups.
| Option | Setup | GA4 coverage | Access |
|---|---|---|---|
| Ryze AI connector | Connect GA4 in Ryze AI with Google sign-in, pick a Property, then add one URL to Cursor (Add to Cursor link or mcp.json). OAuth with PKCE for the Ryze AI sign-in | 9 read tools: reports, pivot, realtime, Admin read, account list and 4 for AI-assistant traffic | Google login with Viewer access; analytics.readonly; no hosting or Google Cloud project to run |
| analytics-mcp (Google, GitHub) | Python 3.10+ and pipx, a Google Cloud project with the Analytics Admin API and Data API enabled, and Application Default Credentials. In Cursor it is a command entry (pipx run analytics-mcp) in mcp.json | 13 tools in the README, including run_report, run_funnel_report, run_conversions_report and run_realtime_report | analytics.readonly; three create tools (annotation, custom dimension, key event) work only with the --allow-write flag and the analytics.edit scope |
Google's server has more reporting tools, such as funnel reports, and can write when you opt in, but it runs on your machine and needs a Google Cloud project and credentials you manage. The Ryze AI connector has 9 read-only tools and nothing to install. It fits when you already use the Ryze AI connector in Cursor for other platforms. If you want funnel reports or GA4 writes and are comfortable with Python and Google Cloud, Google's server is the one to pick. GA4 Data API quotas apply to either route: Google lists 40,000 tokens per property per hour for standard properties.
Sources: Google analytics-mcp on GitHub, GA4 Data API quotas, Cursor MCP documentation, Ryze AI Google Analytics guide. Checked November 14, 2026.
Cursor and Google Analytics errors and fixes
- The GA4 tools do not appear in Cursor
- If GA4 was connected in Ryze AI after the server was added, remove the ryze entry and add it again, then start a new chat so the tool list refreshes.
- Cursor never asks me to sign in
- Open Customize in the sidebar, find the ryze server and reconnect it. Cursor reads the connector's protected resource metadata and registers itself, so no client ID is needed.
- The Ryze AI card says Require setup
- No Property is saved yet. Open the Google Analytics 4 card in Ryze AI, pick the Property (listed as account and property) and click Save.
- No properties are listed
- The Google login you connected has no GA4 access. Use a login with at least Viewer access, or add one more account in Ryze AI.
- Revenue shows as zero
- GA4 reports revenue only when ecommerce tracking and purchase events are set up on the property. Check that in GA4.
- A Cloud Agent cannot reach GA4
- Cloud Agents keep their own MCP sign-ins on Cursor's servers. Connect the Ryze AI server for the agent separately from your desktop.
- The server is blocked on a team account
- Enterprise admins can allowlist which servers and tools the team may run. Ask an admin to allow the Ryze AI server in Team Settings > MCP Configuration.
- The tools reply that a subscription is required
- The GA4 tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Frequently asked questions
How do I connect Cursor to Google Analytics?
Connect Google Analytics 4 in Ryze AI under Integrations, pick the Property, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or a url entry in mcp.json. Sign in when Cursor asks.
Is there a Google Analytics MCP server for Cursor?
Yes. Google publishes the open-source analytics-mcp server on GitHub, which runs locally with pipx and lists 13 tools. The Ryze AI connector at https://connector.get-ryze.ai/mcp is a hosted option with 9 read-only GA4 tools.
Which should I use, Ryze AI or Google's own server?
Ryze AI is the best way to bring GA4 into Cursor with nothing to install and AI-assistant traffic reports, but it has no funnel report and no GA4 writes. Google's analytics-mcp has funnel reports and optional writes, and needs Python and a Google Cloud project.
What Google access do I need?
A Google login with at least Viewer access on a GA4 property. Ryze AI requests the read-only analytics.readonly scope plus basic profile scopes, and you should keep every requested permission checked.
Can Cursor change my GA4 settings?
No. All 9 GA4 tools are read tools. The connector cannot create, edit or delete properties, key events, audiences or other settings, and the Admin read tool is GET only.
Which Cursor plan do I need?
Cursor's MCP documentation names no plan. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration.
Does Cursor ask before running a GA4 tool?
By default, yes. Cursor asks for approval before using MCP tools and follows the same Run Modes as terminal commands. You can allowlist tools if you want them to run without a prompt.
Can I connect more than one GA4 property?
Yes. Connect several Google logins to one workspace with Add one more account, each with its own Property, and set one as primary with the star. Other properties stay reachable by naming them in chat. The help center advises a separate workspace for each client.
Does it support Universal Analytics?
No. Only GA4 properties are supported.
Can Cursor see visits from ChatGPT and Perplexity?
Yes. Four of the tools report traffic from AI referrers by engine, by day, by landing page and by referral source with sessions and conversions. GA4 reports visits that arrive from assistants, not whether an assistant mentions your brand.
Can I use a Ryze AI API key instead of the browser sign-in?
Yes. Add a headers entry with Authorization set to Bearer followed by your rk_live_ key from Workspace Settings > Profile > API keys, and keep the key in an environment variable such as RYZE_API_KEY.
How much does it cost to connect Cursor to Google Analytics?
Adding the connector 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, SEO Starter is $129 per month with a 3-day free trial, and Agency is $279 per month. Annual billing takes 30% off the first year.