By Ira Bodnar, Ryze AI · Updated · Connector tested November 14, 2026
Quick answer
The main way to connect Windsurf to Google Analytics is the Ryze AI connector. Sign in to Google once in Ryze AI and save a GA4 property, then add a ryze entry with the url https://connector.get-ryze.ai/mcp to the Windsurf (now Devin Desktop) MCP config and sign in to Ryze AI when the editor asks.
- In Ryze AI open Integrations, click Connect on Google Analytics 4 and approve the Google screen
- Pick the GA4 property for the workspace and click Save
- In Windsurf add the ryze server with the URL to mcp_config.json
- Authenticate, click Allow connection and ask your first GA4 question
Windsurf to Google Analytics 4 at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector: one hosted MCP address, written as a url entry in mcp_config.json or added with devin mcp add |
| Server address | https://connector.get-ryze.ai/mcp |
| How Windsurf signs in | A browser OAuth sign-in to Ryze AI. Devin registers itself through dynamic client registration, so no client ID or secret goes into the config |
| How Google Analytics is reached | A Google sign-in inside Ryze AI with the read-only analytics.readonly scope. No API key, no service account and no Google Cloud project on your side |
| Google Analytics tools | 9, all read tools: 5 report tools (raw, pivot, realtime, Admin read, account list) and 4 AI-traffic tools |
| Can it change Google Analytics | No. There is no write tool and the scope is read-only. Devin Local asks before every MCP tool call by default |
| Other data in the same chat | Any other platform connected in the same Ryze AI workspace comes through the same address |
| Windsurf plan needed | Cognition's MCP pages name none. The team MCP controls carry the label Teams & Enterprise |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free |
| Google's own option for Windsurf | Google's analytics-mcp server runs as a local command (version 1.1.0 on November 14, 2026). Google's pages name Antigravity, Claude Desktop, Claude Code, Cursor and Gemini tools, and do not name Windsurf |
| Last tested | The Ryze AI tools were called from Claude Code on November 14, 2026. Nothing was run inside Windsurf |
Before you start
- Windsurf (now Devin Desktop) or the Devin CLI. Cognition renamed Windsurf to Devin Desktop on June 2, 2026, and its MCP documentation names no plan for remote servers. Teams can restrict MCP: Allow MCP, the MCP allowlist and the MCP registry settings carry the label Teams & Enterprise, and Enterprise admins manage registries in team settings under MCP & ACP. If the server is blocked, an admin has to allow it.
- A Google login with at least Viewer access on a GA4 property. Viewer is the lowest Google Analytics role that can see data, and Google's own MCP server asks for the same minimum. Universal Analytics properties are not supported. A role carrying the No Cost Metrics or No Revenue Metrics restriction will not return those metrics through any connector.
- A Ryze AI workspace on a 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. Connecting the connector is free, but the Google Analytics tools need an active plan or trial.
How to connect Windsurf to Google Analytics 4 in Devin Desktop
Two steps happen in Ryze AI, three in Windsurf. Google Analytics 4 needs no API key or Cloud project from you. The connector URL is the same for every user.
Connect Google Analytics 4 in Ryze AI
In the Ryze AI app 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.
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 the Windsurf config
In Windsurf open the Customize page from the Agents window, click MCPs and choose a scope with Install MCPs for, for example This computer. Open the config file and add a ryze entry under mcpServers with the url https://connector.get-ryze.ai/mcp. The user file is ~/.config/devin/mcp_config.json and the project file is .devin/mcp_config.json. Cognition's docs describe opening the file of a listed server only, so with an empty list you may have to create the user file yourself.
The server entry is the same in the user file and the project file. Windsurf's Devin docs use the key url for a remote server:
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Devin Local tries Streamable HTTP first and falls back to SSE on non-auth 4xx errors. It registers the OAuth client dynamically, so there is no client ID or secret to paste.
Authenticate with Ryze AI
Back on the MCPs tab, refresh the list. A server that needs authorization shows an Authenticate button, and an OAuth server also asks for a sign-in the first time the agent uses it. Sign in on the Ryze AI page, choose the workspace that holds Google Analytics 4 and click Allow connection.
Ask your first GA4 question
Start a new agent chat and ask: List the Google Analytics accounts and properties I can read, with their property IDs. By default Windsurf asks for approval before it calls an MCP tool, so approve the read when prompted. If the tool list lacks Google Analytics, remove and re-add the ryze server, then start a new chat.
The Ryze AI help center article for Google Analytics 4 covers the Google side of the connection, and Cognition documents the editor side in the Devin Local MCP docs.
Devin CLI
The Devin CLI adds the server from the terminal. The -s user flag stores it in your user config. The second command opens the Ryze AI sign-in page, where you pick the workspace and click Allow connection.
devin mcp add -s user ryze https://connector.get-ryze.ai/mcpdevin mcp login ryzeEach MCP client keeps its own OAuth session, so signing in to Ryze AI in Claude or Cursor does not carry over to Windsurf. You sign in once per tool.
Windsurf and MCP: the facts in one table
Cognition now documents Windsurf under the Devin name. These are the MCP facts from its Devin Desktop and Devin CLI pages as they read on November 14, 2026.
| Topic | What Cognition's documentation says |
|---|---|
| Name and agent | Windsurf has been called Devin Desktop since June 2, 2026. The agent that calls MCP tools is Devin Local; Cascade was removed on September 8, 2026 |
| Config files | ~/.config/devin/mcp_config.json for every project (%APPDATA%\devin\mcp_config.json on Windows), .devin/mcp_config.json committed with a repository, and .devin/mcp_config.local.json, which git ignores |
| Fields of a remote entry | url is required. transport, headers, oauthClientId, oauthClientSecret, oauthResource, oauthScopes, disabled and disabledTools are optional |
| Transports | stdio, Streamable HTTP and SSE. A url is tried over Streamable HTTP first, and SSE only after a 4xx answer that is not about sign-in |
| Sign-in | OAuth with dynamic client registration. Tokens stay on the machine and refresh on their own. Each MCP client keeps a separate session |
| Tool approval | Devin Local asks before any MCP tool call. You can allow one tool or the whole server, for the session or for good |
| Tool names | mcp__<server>__<tool>. With the server named ryze, every Google Analytics tool starts with mcp__ryze__ |
| Rules for tools | Allow, Deny and Ask lists in Devin Local settings. A deny rule always wins over an allow rule |
| Where servers are managed | Customize > MCPs, where a server is switched on or off, its config file opened and the list refreshed. In a terminal: devin mcp list, get, remove, enable and disable |
| Plan and admin controls | No plan is named for adding a server. Allow MCP, the MCP allowlist and MCP registries are team settings for Teams & Enterprise; once one server is allowlisted, every other server is blocked |
Sources: Devin Local customizations, Devin Local permissions, Devin CLI MCP configuration, Devin Desktop admin controls, Devin Desktop changelog. Checked November 14, 2026.
Other clients
The same URL works in other MCP clients. Google Analytics 4 is connected once in Ryze AI, so nothing changes on the Google side.
Claude
Add the URL under Customize, Connectors, Add custom connector, then click Connect and allow the workspace. The Claude to Google Analytics guide has the full steps.
Cursor
Add the same URL as a remote server in Cursor's MCP settings and sign in to Ryze AI. The Cursor to Google Analytics guide covers the file and the menu.
ChatGPT, Codex and Gemini
Each has its own connector flow with the same URL and the same Ryze AI sign-in. Google Analytics 4 is connected once in Ryze AI, so nothing changes on the Google side.
Google Analytics 4 access and scopes
Three things decide what Windsurf can see in Google Analytics: the Google scope Ryze AI asks for, the role your Google login holds on the property, and the tool approvals in Windsurf.
- Which property
- You save one Property for the workspace after the Google sign-in. Several Google logins can be connected to one workspace with Add one more account, each with its own property, and the primary one is what the agent uses by default. Other properties stay reachable by naming them in chat.
- What the connection can change
- Nothing. Ryze AI asks only for the read-only analytics.readonly scope and has no Google Analytics write tool, so it cannot create or edit properties, key events, audiences or other settings.
- Which role
- The Google login needs at least Viewer on the property. A wrong or unknown property ID gets the same permission answer as a property the login cannot read.
- Windsurf approvals
- By default Devin Local asks for approval before it runs any MCP tool, and Enterprise admins can default-allow trusted servers or tools. All 9 Google Analytics tools only read, so allowing the whole ryze server for a session is a low-risk choice for GA4, but it also covers any other platform you connect in the same workspace.
Keep every permission on the Google screen checked when you connect. If a permission is unchecked, the connection may lack what the tools need.
Google scopes and roles behind the Ryze AI connection
Windsurf holds only a Ryze AI sign-in. Google judges every request by the scope Ryze AI was granted and by the role your login holds on the property. The middle column quotes Google's scope list and role page as read on November 14, 2026.
| Google access | What Google says it covers | With Ryze AI |
|---|---|---|
| analytics.readonly | "See and download your Google Analytics data", under both the Data API and the Admin API | Requested. Every Google Analytics tool depends on it |
| openid, email, profile | Associate you with your Google account, see its primary email address and your public profile info | Requested as basic profile scopes next to the Analytics scope |
| Viewer role | "Can see settings and data; can change which data appears in reports" | The minimum your login needs on the property. Google's own MCP server asks for the same |
| No Cost Metrics, No Revenue Metrics | Data restrictions a role can carry. Google says they are enforced in the interface and in API calls | A login with either restriction will not get cost or revenue metrics through the connector |
Not part of the connection: analytics.edit ("Edit Google Analytics management entities"), analytics.chatbot.read (the scope of the Ask Advisor chat method), and the Marketer and Editor roles. Nothing is created or changed in GA4, and Ryze AI does not call the Ask Advisor method. Revenue shows as zero unless ecommerce tracking and purchase events are set up in the property.
Sources: Google OAuth scopes, Google Analytics roles and restrictions, Ryze AI Google Analytics 4 guide. Checked November 14, 2026.
Removing access
To remove access, disconnect Google Analytics 4 on its card in Ryze AI, or remove Ryze AI from the apps with access in your Google account settings. In Windsurf, switch the ryze server off under Customize > MCPs or remove its entry from mcp_config.json; in the Devin CLI, devin mcp remove ryze does the same.
What Windsurf can do in Google Analytics 4
The Ryze AI connector exposes 9 Google Analytics 4 tools, all of them read tools. Every tool except the account list and the Admin read takes a property ID, and no property is picked for you.
| 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 report 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. |
| 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. |
Calls that were run
| Call | What came back on November 14, 2026 |
|---|---|
| listAccountSummaries | Worked on November 14, 2026. It returned account summaries, each with property summaries (property, displayName, propertyType, parent, canEdit). |
| runRawReport, one day and one metric | Worked. It returned one row with metric headers, a row count, metadata (currency code and time zone) and a propertyQuota block when asked for it. The metric value is not recorded here. |
All 9 tools only read, so nothing changes in GA4. In the Ryze AI chat the Tool approvals picker starts on Skip all approvals and can be switched to Approve write & delete or Manual approve. Scheduled tasks run without an approval step. Inside Windsurf, the client asks before each MCP tool call by default.
Google Analytics 4 limits in numbers
Google counts most Data API limits per property, and a standard property has the smaller numbers below. The Analytics 360 figures are higher and are on the linked page. Three caps below come from what the API answered to the Ryze AI test calls on November 14, 2026.
| Limit | Detail |
|---|---|
| Daily token budget | 200,000 core tokens per property per day on a standard property. Daily quotas refresh at midnight Pacific time |
| Hourly token budget | 40,000 per property per hour, and 14,000 per Google Cloud project per property per hour |
| Concurrent requests | 10 per property on a standard property |
| Cost of one request | Google says most requests cost 10 tokens or fewer. More rows, more dimensions and metrics, complex filters, long date ranges and high-cardinality dimensions such as pagePath cost more. A one-day, one-metric test report cost 1 token |
| When a quota runs out | A 429 RESOURCE_EXHAUSTED error for that property. Hourly quotas refresh within an hour |
| Server errors | 10 per project per property per hour on a standard property. Past it, all requests from that project to that property are blocked |
| Realtime reports | A separate quota with the same figures as core. The window runs from now back 30 minutes, and up to two minute ranges can be used in one query |
| Demographic dimensions | 120 potentially thresholded requests per property per hour, for dimensions such as userAgeBracket and userGender |
| Rows per report | 10,000 by default, at most 250,000 per request. Larger results are paged with offset |
| Dimensions, metrics and date ranges per report | 9 dimensions, per Google's report guide. The test calls were refused at 10 dimensions, at 11 metrics (a cap of 10) and at 5 date ranges (a cap of 4) |
| Admin API rate limits | 1,200 requests per minute and 600 per minute per user. The write quotas do not matter here because the Ryze AI tools only read |
| Data delay | Standard properties: intraday data typically 2 to 6 hours old and daily data 12 hours. Google says processing can take 24 to 48 hours, and data may change in that time |
| Data retention | 2 or 14 months on a standard property, a setting that affects explorations and funnel reports only. Standard aggregated reports are not affected |
| Ryze AI tool inputs | getAiLandingPages returns at most 200 rows. runRawReport defaults to 10,000 rows and pages with offset. AI-traffic tools take dates as YYYY-MM-DD |
Sources: Data API quotas, Data API runReport reference, Realtime reports, Admin API quotas, Data freshness, Data retention, Property limits. Checked November 14, 2026.
First 3 prompts to run
1. Find the property first
List the Google Analytics accounts and properties I can read, with each property ID, so I can name the right one in later questions.
Tools used: google_analytics__listAccountSummaries
What comes back: A list of accounts with their properties and property IDs for the connected Google login. Later prompts can name a property by ID.
2. Channel report with a comparison
For my main property, report sessions and key events by default channel group for last month, compared with the month before. Name the two date ranges.
Tools used: google_analytics__runRawReport
What comes back: A report with one set of rows per named date range. Naming each range keeps the comparison from being mismapped.
3. Visits from AI assistants
Which AI assistants sent visits to my property in the last 30 days compared with the 30 days before, and which landing pages received them?
Tools used: google_analytics__getAiTrafficByEngine, google_analytics__getAiLandingPages
What comes back: Visits grouped by AI engine against the prior period, then the top landing pages for AI-referred traffic.
Each answer comes from your own property, so this page describes what comes back instead of showing sample numbers. GA4 reports visits that arrive from AI assistants. It does not show whether an assistant mentions your brand.
10 jobs to hand to Windsurf
Ten jobs to give the Devin Local agent, each with the Ryze AI tool behind it. Only the first was run for this guide, from Claude Code. The last column assumes the default connection: the read-only scope and a login with Viewer access.
| Job | Ask the agent | Tool | Works on the default connection |
|---|---|---|---|
| Property list | List every GA4 account and property this Google login can read, with property IDs. | google_analytics__listAccountSummaries | Yes. Ran in the November 14 test |
| Channel comparison | Report sessions, key events and revenue by default channel group for last month against the month before. | google_analytics__runRawReport | Yes. Up to 4 date ranges, 9 dimensions and 10 metrics per report |
| Top landing pages | Show the top landing pages by sessions with engagement rate and key event rate for the last 28 days. | google_analytics__runRawReport | Yes |
| Revenue by source | Report purchase revenue and purchases by source and medium. | google_analytics__runRawReport | Yes, once ecommerce tracking and purchase events are set up. A login with No Revenue Metrics will not see revenue |
| Device pivot | Pivot sessions by channel across device categories. | google_analytics__runPivotReport | Yes. Not run in the test |
| Live traffic | Who is on the site right now, by country and device, for the last 30 minutes? | google_analytics__runRealtimeReport | Yes. Realtime covers the last 30 minutes only |
| Property setup check | List the key events, custom dimensions and audiences configured in the property. | google_analytics__runAdminRead | Yes, read only. Audiences are read with the v1alpha version |
| AI engines | Which AI assistants sent visits in the last 30 days, compared with the 30 days before? | google_analytics__getAiTrafficByEngine | Yes. Not run in the test |
| AI daily trend | Show the daily trend of visits from AI assistants such as ChatGPT and Perplexity. | google_analytics__getAiTrafficDaily | Yes. Not run in the test |
| AI referral pages | List the landing pages that receive AI-referred visits, and each AI referral source with sessions and conversions. | google_analytics__getAiLandingPages and google_analytics__getAIReferrals | Yes. Landing pages come back up to 200 rows |
3 ways to connect Windsurf to Google Analytics 4
Three ways reach Google Analytics 4 from Windsurf and have a vendor page that names Windsurf: the Ryze AI connector, Zapier MCP and an open-source server by surendranb. This guide treats the Ryze AI connector as the main way: one url entry, a Google sign-in done in Ryze AI, and nine read tools. The other two are described from their own pages as read on November 14, 2026. Google's own server and others whose pages do not name Windsurf are listed below the table. None was run inside Windsurf.
| Way | Runs where | Setup in Windsurf | What it reaches in GA4 | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI. One address for every user | A ryze entry with the url https://connector.get-ryze.ai/mcp in mcp_config.json, or devin mcp add -s user ryze with that address, then a browser sign-in to Ryze AI | 9 read tools: Data API reports, pivot and realtime reports, Admin API reads, the account list and 4 AI-traffic tools. No write | Paid Ads is $89 per month with a 7-day free trial; the connector itself is free |
| Zapier MCP | Hosted by Zapier | Add Zapier as a connector and sign in. Zapier's quickstart lists Windsurf among its clients and needs a client that speaks MCP over Streamable HTTP | 6 Google Analytics 4 actions: Create Conversion Event for a Property, Create Measurement, Run Report for a Property, Send Measurement Events for an Application, API Request and Find Conversion. Read and write | Each successful tool call uses two tasks from your Zapier plan. Free is $0 with 100 tasks per month; Professional starts at $19.99 per month |
| surendranb/google-analytics-mcp | A local process your editor starts, with a service account JSON file | A local command entry (command, args, env) in mcp_config.json, which Cognition's docs support, with the property ID and credentials file in env. The README names Windsurf for its one-line installer; this guide did not run it | 8 tools in the README: get_ga4_data, list_accounts, list_properties, get_property_metadata, run_realtime_report and 3 skills tools. Read only | Free under the MIT license. 244 GitHub stars on November 14, 2026. The README says it collects anonymous diagnostic telemetry, with an opt-out |
Options whose pages do not name Windsurf
- Google's analytics-mcp server (the local one). Open source from the Google Analytics team under Apache-2.0, version 1.1.0 on November 14, 2026, about 3,780 GitHub stars. It runs as a command your assistant starts (pipx run analytics-mcp or uvx --from analytics-mcp google-analytics-mcp). You need Python 3.10 or higher, a Google Cloud project with the Analytics Admin and Data APIs enabled, Application Default Credentials with the analytics.readonly scope, and at least the Viewer role. Google's docs list 9 read tools, and the README lists 13: those 9 plus list_key_events and three opt-in write tools, available only with --allow-write and the analytics.edit scope. Google's pages name Antigravity, Claude Desktop, Claude Code, Cursor, Gemini CLI and Gemini Code Assist; Windsurf is not named. Cognition's docs accept command, args and env entries, but this guide did not run it in Windsurf.
- Google's server in HTTP mode. Since version 1.0.0 the same package can run as a multi-tenant Streamable HTTP server with a built-in OAuth 2.1 provider, with Docker and Cloud Run instructions added in 1.1.0. You host it and create the Google OAuth client yourself. The README says the built-in provider keeps registrations and refresh tokens in process memory, so restarts require signing in again. It names no chat assistant.
- Google-hosted MCP endpoints. Google hosts an endpoint for the Data API at https://analyticsdata.googleapis.com/mcp/v1 with four read tools. Its HTML reference page returned 404 on November 14, 2026 while a Markdown copy loaded, and Google's list of supported remote MCP servers does not include Google Analytics, so this guide treats it as not announced. Google says its remote MCP servers do not support Dynamic Client Registration, so connecting needs your own Google credentials. No setup steps are given here.
- Composio. A hosted server with 82 tools on its Google Analytics toolkit page, read and write, using Composio's managed Google sign-in. Its pricing page lists Free at $0 with 10,000 tool calls per month and Standard at $18 per seat per month. Its assistant list names Claude Code, ChatGPT, Cursor, Codex, VS Code and others; Windsurf is not on it.
- Windsor.ai. A hosted connector in Claude's directory that reads GA4 data (read only) next to 350+ other sources. Plans start with a Forever Free tier of 1 data source and 1 account, then Basic at $23 per month. Its guides name Claude, ChatGPT, Gemini, Perplexity, Cursor, Antigravity and others; Windsurf is missing.
- Coupler.io. A hosted server that queries a synced copy of your GA4 data, not GA4 itself, refreshed on a schedule. It is read only, and each data flow carries up to 10 metrics and 9 dimensions. Free is $0 with manual refresh and Starter is $32 per month. It names Claude, ChatGPT, Gemini, Perplexity, Cursor, Copilot and OpenClaw, or a custom MCP endpoint with a bearer token, so a custom entry could in principle serve Windsurf, which this guide did not try.
Which one to pick
Ryze AI is the best way to connect Windsurf to Google Analytics 4 when you want a Google sign-in with no Cloud project, key or local install, and GA4 in the same Devin Local chat as the other platforms in your Ryze AI workspace, with one caveat: it has nine read tools and cannot write, while Google's own server adds funnel and conversions reports and opt-in write tools. Pick Google's server when you want those tools and are happy to run Python and manage Google credentials, and it can sit in mcp_config.json beside the ryze entry under its own name. Zapier fits when sending events or creating key events from the agent is the job. If you want a free local option that names Windsurf, surendranb's server is the one described above.
Sources: Google Analytics MCP server docs, google-analytics-mcp README, analytics-mcp on PyPI, Google Cloud: configure MCP in an AI application, Google Cloud supported MCP servers, Composio Google Analytics toolkit, Composio pricing, Zapier Google Analytics 4 MCP, Zapier MCP quickstart, Windsor.ai Google Analytics 4 MCP, Windsor.ai pricing, Coupler.io Google Analytics MCP, Coupler.io pricing, surendranb/google-analytics-mcp, Devin CLI MCP configuration, Ryze AI Google Analytics 4 guide. Checked November 14, 2026.
Windsurf, Google Analytics and MCP: dates that matter
| Date | What happened |
|---|---|
| May 6, 2024 | The Data API introduced key event dimensions and metrics. conversions became a deprecated metric name, replaced by keyEvents. |
| February 13, 2025 | Cognition's Windsurf Wave 3 post brought MCP server support to Cascade, for individual plans first. |
| July 17, 2025 | Windsurf 1.11.0 added the Streamable HTTP transport and MCP authentication in place of tokens or API keys in the config. |
| July 30, 2025 | The Google Analytics team announced its MCP server in the Google Analytics API Notify group. |
| August 22, 2025 | analytics-mcp 0.1.0, the first release of Google's server, appeared on PyPI and GitHub. |
| April 29, 2026 | Windsurf 2.1.29 let users switch on the Devin Local agent and opened the CLI agent to all Windsurf users on their existing subscription. |
| June 2, 2026 | Windsurf became Devin Desktop (v3.0.12). |
| July 29, 2026 | Devin CLI v3000.3.22 moved MCP servers out of config.json into mcp_config.json files, and Devin Desktop 3.6.21 added the Authenticate button for servers that report Needs auth. |
| September 8, 2026 | Devin Desktop 3.9.19 removed Cascade, leaving Devin Local as the only built-in agent. |
| October 22, 2026 | analytics-mcp 0.8.0 added the first write tool (create_property_annotation), the --allow-write flag and MCP tool annotations. |
| November 3, 2026 | analytics-mcp 1.0.0 added the multi-tenant Streamable HTTP transport and OAuth 2.1 support. Its release note says it graduates from experimental. |
| November 6, 2026 | analytics-mcp 1.1.0 added Docker and Cloud Run docs, opt-in Admin API write tools (custom dimensions, key events) and minute ranges in the realtime report. It was the newest version on November 14. |
| November 10, 2026 | Google's page Try the Google Analytics MCP server was last updated. It lists Antigravity, Claude Desktop, Claude Code and Cursor, and says Gemini CLI is deprecated. |
| November 12, 2026 | Devin Desktop v3.12.59 came out and was still the newest version on November 14, 2026. |
Sources: Devin Desktop changelog, Devin CLI changelog, Windsurf Wave 3 post, Data API changelog, analytics-mcp releases, Google Analytics MCP server docs, Google Analytics API announcement group. Checked November 14, 2026.
How this guide was tested
Eight Google Analytics 4 calls were made through the Ryze AI connector on November 14, 2026, from Claude Code, against a test workspace with a standard property and the default read-only connection. All were reads. No account name, property ID or metric value is recorded on this page. The table lists what was run and what came back.
| What was run | What came back |
|---|---|
| Loading all 9 tool definitions by name | All 9 returned a definition. No tool name contains a write verb. Every tool takes a workspace; every tool except listAccountSummaries and runAdminRead requires propertyId. |
| listAccountSummaries | Worked. It returned accounts with their property summaries. |
| runRawReport, one day, one metric, with the quota block requested | Worked. One row came back with the propertyQuota block. The request cost 1 token, and the block's totals equal the standard-property limits on Google's quotas page. |
| runRawReport with a dimension name that does not exist | Refused with 400 INVALID_ARGUMENT, and Google suggested a close name. No data came back. |
| runRawReport with a metric name that does not exist | Refused with 400 INVALID_ARGUMENT, with a suggested name. No data came back. |
| runRawReport with a property ID that does not exist | Refused with status not_allowed, returned as a normal tool result. No data came back. |
| runRawReport with 10 dimensions, with 5 date ranges and with 11 metrics | Each refused with 400 INVALID_ARGUMENT. The messages are in the error list below. |
| Google's pages | The quotas, scopes, roles, changelog and Google Analytics MCP pages were read on November 14, 2026, along with the other vendors' pages used in the ways table. |
Not run for this guide: any step inside Windsurf. Devin Desktop and the Devin CLI were not opened, so the config entry, the Authenticate button, devin mcp add, devin mcp login and the approval prompt follow Cognition's documentation as read on November 14, 2026. The pivot, realtime and Admin read tools and the four AI-traffic tools were not called, because they would return business data from a real account; their definitions were loaded. No authenticated call was made to Google's own servers, Zapier, Composio, Windsor.ai, Coupler.io or surendranb's server.
Google Analytics 4 errors and fixes
The first six messages were returned by Google's Data API to the test calls on November 14, 2026. The rest come from Cognition's and Google's documentation.
Messages from the test calls
- Did you mean manualSource? Field trafficSauce is not a valid dimension.
- 400 INVALID_ARGUMENT. The dimension name does not exist; the test sent one on purpose. Ask again with a real name such as sessionSource, or use the name Google suggests.
- Did you mean sessions? Field sessionz is not a valid metric.
- 400 INVALID_ARGUMENT. The metric name does not exist. Use the suggested name. conversions is a deprecated name, and the current one is keyEvents.
- User does not have sufficient permissions for this property.
- Returned with status not_allowed. The property ID does not exist or your Google login has no role on it, and Google gives the same answer in both cases. Run listAccountSummaries for the IDs the login can read, or ask a property admin for Viewer.
- Requests are limited to 9 dimensions within a nested request.
- 400 INVALID_ARGUMENT, answered to a 10-dimension request. Ask for fewer breakdowns, or split the question into two reports.
- Requests are limited to 10 metrics within a nested request.
- 400 INVALID_ARGUMENT, answered to an 11-metric request. Ask for 10 metrics or fewer per report.
- Requests are limited to 4 dateRanges.
- 400 INVALID_ARGUMENT, answered to a 5-range request. Compare up to 4 periods per report, or use a date dimension over one longer range.
Other errors and fixes
- 429 RESOURCE_EXHAUSTED
- Google's answer when a quota bucket for the property has run out. Daily quotas refresh at midnight Pacific time and hourly ones within an hour. Ask for fewer rows or dimensions meanwhile.
- Auth required or AuthRequired
- Cognition's docs say these mean the remote server wants an OAuth sign-in. Click Authenticate on the MCPs tab, or run devin mcp login ryze in the Devin CLI.
- The ryze server shows Needs authentication
- Cognition's docs tie this state to stored OAuth credentials that have expired. Click Authenticate in the MCP list to restart the browser sign-in. In the Devin CLI, run devin mcp logout ryze and then devin mcp login ryze.
- Ryze AI sign-in worked in another tool but not in Windsurf
- Each MCP client keeps its own OAuth session. Sign in once in Windsurf.
- The server does not appear after editing the file
- Check that the JSON is valid, that the entry sits under mcpServers and that you edited the file for the scope you are viewing, then refresh the MCP list.
- Windsurf asks for approval on every call
- That is the default. Enterprise admins can default-allow trusted servers or tools, and you can add Allow rules for single tools in Devin Local settings.
- Google Analytics tools are missing
- Google Analytics 4 must be connected in the Ryze AI workspace you allowed, with a property saved. Claude and ChatGPT cache the tool list, so if the connector was added before GA4 was connected, remove and re-add it, then start a new chat.
- The card shows Require setup
- No property is saved yet. Open the Google Analytics 4 card in Ryze AI, pick the Property and click Save.
- Revenue shows as zero
- GA4 reports revenue only when ecommerce tracking and purchase events are set up in the property. A Google role with No Revenue Metrics also hides it.
- The tools say a subscription is required
- The Google Analytics tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI, then retry.
Sources: Devin CLI MCP configuration, Data API errors, Data API quotas, Data API property ID. Checked November 14, 2026.
Terms on this page
- MCP
- The Model Context Protocol, an open standard that lets an AI app call tools on outside systems. Devin Desktop, the Devin CLI and Ryze AI all speak it.
- Devin Local
- The agent inside Devin Desktop, the new name of Windsurf, that runs MCP tools. It took over from Cascade.
- mcp_config.json
- The file where Devin Desktop and the Devin CLI list their MCP servers, under the mcpServers key.
- Property and property ID
- The unit of Google Analytics that reports are produced for. Every Data API request names a numeric property ID, shown under Admin, Property Settings. Universal Analytics properties do not work.
- Key event
- Google's name for an action that matters to the business, formerly called a conversion. The API metric is keyEvents.
- Dimension and metric
- Metrics are measurements such as active users or event count. Dimensions break metrics down by criteria such as country or event name.
- Token (Data API quota)
- The unit Google charges per report request. A standard property has 200,000 per day and 40,000 per hour.
Sources: modelcontextprotocol.io, Devin Local overview, Google Analytics property ID, Key events, Default channel group, Data API quotas, Google Analytics roles. Checked November 14, 2026.
Frequently asked questions
How do I connect Windsurf to Google Analytics?
Connect Google Analytics 4 in Ryze AI under Integrations with a Google sign-in and save a property. Then add a ryze entry with the url https://connector.get-ryze.ai/mcp to mcp_config.json in Windsurf, authenticate and click Allow connection.
Does Google Analytics have an MCP server?
Yes. Google publishes an open-source server, analytics-mcp, that runs as a local command, and it reached version 1.1.0 on November 6, 2026. Google also hosts a Data API endpoint at https://analyticsdata.googleapis.com/mcp/v1, but its reference page returned 404 on November 14, 2026 while a Markdown copy loaded, so treat it as not announced.
What is the Google Analytics MCP URL for Windsurf?
For the Ryze AI connector it is https://connector.get-ryze.ai/mcp, the same for every user, in a ryze entry under mcpServers. Google's own server has no URL because it runs as a local command, and connecting to Google's hosted endpoint needs your own Google credentials.
Is there a Google Analytics connector for Windsurf?
The Ryze AI connector works in Windsurf as a url entry in mcp_config.json. Zapier MCP names Windsurf among its clients, and surendranb's open-source server names it for its installer. Google's pages name Antigravity, Claude Desktop, Claude Code and Cursor but not Windsurf.
Which Google Analytics MCP option should I use in Windsurf?
Take the Ryze AI connector for a Google sign-in with no Cloud project and nine read tools. Take Google's own server if you need its funnel and conversions reports or opt-in write tools and can run Python with Google credentials. Take Zapier if the job is sending events.
Is Windsurf now called Devin Desktop?
Yes. Cognition renamed Windsurf to Devin Desktop on June 2, 2026, and its docs say both names mean the same product. The MCP documentation moved to docs.devin.ai, so this guide uses both names and follows the Devin Local steps.
Can I still set up Google Analytics through Cascade?
Not in Devin Desktop. It removed Cascade on September 8, 2026, and Devin Local is now the only built-in agent. Use the MCPs tab on the Customize page or edit ~/.config/devin/mcp_config.json instead.
What Google Analytics access do I need?
A Google login with at least the Viewer role on a GA4 property. Ryze AI asks for the read-only analytics.readonly scope plus basic profile scopes. Universal Analytics properties are not supported.
Do I need a paid Windsurf plan?
Cognition's MCP documentation names no plan, and its pricing page has no MCP row. Allow MCP, the MCP allowlist and MCP registries are team settings labelled Teams & Enterprise, so an admin on those plans may have to allow the Ryze AI server.
Can Windsurf change anything in Google Analytics?
No. The Ryze AI connector has 9 Google Analytics tools, all read tools, and the connection holds only the read-only scope. It cannot create or edit properties, key events, audiences or other settings. Windsurf also asks for approval before each MCP tool call by default.
How many Google Analytics requests can Windsurf make?
Google gives a standard property 200,000 Data API tokens per day and 40,000 per hour, with 10 concurrent requests. Most requests cost 10 tokens or fewer, and a one-day, one-metric test report cost 1 token. When a quota runs out the API answers 429 RESOURCE_EXHAUSTED.
Can I connect more than one GA4 property?
Yes. Several Google logins can be connected to one workspace with Add one more account, each with its own property, and the primary one is what the agent uses by default. Other properties stay reachable by naming them in chat, and the agent can find property IDs with listAccountSummaries.
Does this work in the Devin CLI?
Yes. Run devin mcp add -s user ryze https://connector.get-ryze.ai/mcp, then devin mcp login ryze and click Allow connection on the Ryze AI page.
Can Windsurf show which AI assistants send me traffic?
Yes, through 4 AI-traffic tools: by engine against a prior period, by day, by landing page and by referral source with sessions and conversions. GA4 reports visits that arrive from assistants such as ChatGPT and Perplexity. It does not report whether an assistant mentions your brand.
How much does it cost to connect Windsurf to Google Analytics?
Adding the connector costs nothing, but the Google Analytics 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.
How do I disconnect Google Analytics from Windsurf?
Remove the ryze entry from mcp_config.json. To cut Google Analytics off at the source, disconnect it on its card in Ryze AI or remove Ryze AI from the apps with access in your Google account.