How to connect Windsurf to Google Analytics

Connect Google Analytics 4 once in Ryze AI with a Google sign-in, add one MCP URL to Windsurf, then ask for GA4 reports, realtime traffic and AI-referral visits from the editor.

Your MCP URL
https://connector.get-ryze.ai/mcp

Paste it as the url of a ryze server in the Windsurf MCP config. See the steps

See pricing

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.

  1. In Ryze AI open Integrations, click Connect on Google Analytics 4 and approve the Google screen
  2. Pick the GA4 property for the workspace and click Save
  3. In Windsurf add the ryze server with the URL to mcp_config.json
  4. Authenticate, click Allow connection and ask your first GA4 question

Windsurf to Google Analytics 4 at a glance

FactDetail
Main way to connectThe Ryze AI connector: one hosted MCP address, written as a url entry in mcp_config.json or added with devin mcp add
Server addresshttps://connector.get-ryze.ai/mcp
How Windsurf signs inA 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 reachedA 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 tools9, all read tools: 5 report tools (raw, pivot, realtime, Admin read, account list) and 4 AI-traffic tools
Can it change Google AnalyticsNo. 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 chatAny other platform connected in the same Ryze AI workspace comes through the same address
Windsurf plan neededCognition's MCP pages name none. The team MCP controls carry the label Teams & Enterprise
Ryze AI pricePaid Ads is $89 per month with a 7-day free trial. Adding the connector is free
Google's own option for WindsurfGoogle'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 testedThe 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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 ryze

Each 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.

TopicWhat Cognition's documentation says
Name and agentWindsurf 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 entryurl is required. transport, headers, oauthClientId, oauthClientSecret, oauthResource, oauthScopes, disabled and disabledTools are optional
Transportsstdio, 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-inOAuth with dynamic client registration. Tokens stay on the machine and refresh on their own. Each MCP client keeps a separate session
Tool approvalDevin Local asks before any MCP tool call. You can allow one tool or the whole server, for the session or for good
Tool namesmcp__<server>__<tool>. With the server named ryze, every Google Analytics tool starts with mcp__ryze__
Rules for toolsAllow, Deny and Ask lists in Devin Local settings. A deny rule always wins over an allow rule
Where servers are managedCustomize > 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 controlsNo 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 accessWhat Google says it coversWith Ryze AI
analytics.readonly"See and download your Google Analytics data", under both the Data API and the Admin APIRequested. Every Google Analytics tool depends on it
openid, email, profileAssociate you with your Google account, see its primary email address and your public profile infoRequested 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 MetricsData restrictions a role can carry. Google says they are enforced in the interface and in API callsA 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.

ToolTypeWhat it does
google_analytics__listAccountSummariesReadLists the GA4 accounts and properties the connected Google login can access, so the agent can find property IDs.
google_analytics__runRawReportReadRuns a GA4 Data API report with chosen dimensions, metrics, named date ranges, filters and ordering, and pages through the results.
google_analytics__runPivotReportReadRuns a GA4 Data API pivot-table report.
google_analytics__runRealtimeReportReadRuns a GA4 Data API realtime report covering the last 30 minutes.
google_analytics__runAdminReadReadReads a GA4 Admin API resource such as key events, custom dimensions or audiences. It is GET only and cannot write.
google_analytics__getAiTrafficByEngineReadReturns traffic from AI referrers grouped by source engine and compared with a prior period.
google_analytics__getAiTrafficDailyReadReturns daily traffic from AI referrers such as ChatGPT and Perplexity.
google_analytics__getAiLandingPagesReadLists the top landing pages that receive AI-referred traffic, up to 200 rows.
google_analytics__getAIReferralsReadLists AI referral sources with their sessions and conversions.

Calls that were run

CallWhat came back on November 14, 2026
listAccountSummariesWorked on November 14, 2026. It returned account summaries, each with property summaries (property, displayName, propertyType, parent, canEdit).
runRawReport, one day and one metricWorked. 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.

LimitDetail
Daily token budget200,000 core tokens per property per day on a standard property. Daily quotas refresh at midnight Pacific time
Hourly token budget40,000 per property per hour, and 14,000 per Google Cloud project per property per hour
Concurrent requests10 per property on a standard property
Cost of one requestGoogle 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 outA 429 RESOURCE_EXHAUSTED error for that property. Hourly quotas refresh within an hour
Server errors10 per project per property per hour on a standard property. Past it, all requests from that project to that property are blocked
Realtime reportsA 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 dimensions120 potentially thresholded requests per property per hour, for dimensions such as userAgeBracket and userGender
Rows per report10,000 by default, at most 250,000 per request. Larger results are paged with offset
Dimensions, metrics and date ranges per report9 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 limits1,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 delayStandard 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 retention2 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 inputsgetAiLandingPages 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.

JobAsk the agentToolWorks on the default connection
Property listList every GA4 account and property this Google login can read, with property IDs.google_analytics__listAccountSummariesYes. Ran in the November 14 test
Channel comparisonReport sessions, key events and revenue by default channel group for last month against the month before.google_analytics__runRawReportYes. Up to 4 date ranges, 9 dimensions and 10 metrics per report
Top landing pagesShow the top landing pages by sessions with engagement rate and key event rate for the last 28 days.google_analytics__runRawReportYes
Revenue by sourceReport purchase revenue and purchases by source and medium.google_analytics__runRawReportYes, once ecommerce tracking and purchase events are set up. A login with No Revenue Metrics will not see revenue
Device pivotPivot sessions by channel across device categories.google_analytics__runPivotReportYes. Not run in the test
Live trafficWho is on the site right now, by country and device, for the last 30 minutes?google_analytics__runRealtimeReportYes. Realtime covers the last 30 minutes only
Property setup checkList the key events, custom dimensions and audiences configured in the property.google_analytics__runAdminReadYes, read only. Audiences are read with the v1alpha version
AI enginesWhich AI assistants sent visits in the last 30 days, compared with the 30 days before?google_analytics__getAiTrafficByEngineYes. Not run in the test
AI daily trendShow the daily trend of visits from AI assistants such as ChatGPT and Perplexity.google_analytics__getAiTrafficDailyYes. Not run in the test
AI referral pagesList the landing pages that receive AI-referred visits, and each AI referral source with sessions and conversions.google_analytics__getAiLandingPages and google_analytics__getAIReferralsYes. 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.

WayRuns whereSetup in WindsurfWhat it reaches in GA4Price
Ryze AI connector (the main way)Hosted by Ryze AI. One address for every userA 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 AI9 read tools: Data API reports, pivot and realtime reports, Admin API reads, the account list and 4 AI-traffic tools. No writePaid Ads is $89 per month with a 7-day free trial; the connector itself is free
Zapier MCPHosted by ZapierAdd Zapier as a connector and sign in. Zapier's quickstart lists Windsurf among its clients and needs a client that speaks MCP over Streamable HTTP6 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 writeEach 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-mcpA local process your editor starts, with a service account JSON fileA 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 it8 tools in the README: get_ga4_data, list_accounts, list_properties, get_property_metadata, run_realtime_report and 3 skills tools. Read onlyFree 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

DateWhat happened
May 6, 2024The Data API introduced key event dimensions and metrics. conversions became a deprecated metric name, replaced by keyEvents.
February 13, 2025Cognition's Windsurf Wave 3 post brought MCP server support to Cascade, for individual plans first.
July 17, 2025Windsurf 1.11.0 added the Streamable HTTP transport and MCP authentication in place of tokens or API keys in the config.
July 30, 2025The Google Analytics team announced its MCP server in the Google Analytics API Notify group.
August 22, 2025analytics-mcp 0.1.0, the first release of Google's server, appeared on PyPI and GitHub.
April 29, 2026Windsurf 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, 2026Windsurf became Devin Desktop (v3.0.12).
July 29, 2026Devin 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, 2026Devin Desktop 3.9.19 removed Cascade, leaving Devin Local as the only built-in agent.
October 22, 2026analytics-mcp 0.8.0 added the first write tool (create_property_annotation), the --allow-write flag and MCP tool annotations.
November 3, 2026analytics-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, 2026analytics-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, 2026Google'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, 2026Devin 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 runWhat came back
Loading all 9 tool definitions by nameAll 9 returned a definition. No tool name contains a write verb. Every tool takes a workspace; every tool except listAccountSummaries and runAdminRead requires propertyId.
listAccountSummariesWorked. It returned accounts with their property summaries.
runRawReport, one day, one metric, with the quota block requestedWorked. 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 existRefused with 400 INVALID_ARGUMENT, and Google suggested a close name. No data came back.
runRawReport with a metric name that does not existRefused with 400 INVALID_ARGUMENT, with a suggested name. No data came back.
runRawReport with a property ID that does not existRefused 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 metricsEach refused with 400 INVALID_ARGUMENT. The messages are in the error list below.
Google's pagesThe 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.

Connect Google Analytics 4 to Windsurf through Ryze AI

One Ryze AI connection gives Windsurf 9 read-only Google Analytics 4 tools. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

Need help? Read the Ryze AI help center Google Analytics 4 article or email Ryze AI support.