How to connect Microsoft Copilot to Google Analytics

Sign in to Google Analytics 4 once inside Ryze AI, add one MCP URL as a tool on a Copilot Studio agent or a Microsoft 365 Copilot declarative agent, then ask for channel reports, landing pages and AI-assistant traffic.

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

Copies the link and opens Copilot Studio. Then add it under your agent, Tools, Add a tool, New tool, Model Context Protocol. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · Sources checked November 14, 2026

Quick answer

The main way to connect Microsoft Copilot to Google Analytics is the Ryze AI connector. Microsoft's pages show no Copilot chat window with a field for an MCP address, so the connector goes onto an agent: connect GA4 in Ryze AI with Google sign-in, then on a Copilot Studio agent add https://connector.get-ryze.ai/mcp as a Model Context Protocol tool with OAuth 2.0 and Dynamic discovery, and sign in to Ryze AI. The agent then holds 9 Google Analytics tools, all of them read tools, so it cannot change anything in GA4.

  1. In Ryze AI open Integrations, click Connect on Google Analytics 4, approve every permission on the Google screen, then pick the Property and click Save
  2. In Copilot Studio switch to the classic experience, open your agent, then Tools, Add a tool, New tool, Model Context Protocol
  3. Enter a name, a description and the URL, pick OAuth 2.0 with Dynamic discovery, then select Create and Next
  4. Create a new connection, sign in to Ryze AI, select Add to agent and ask a GA4 question in the test chat

Microsoft Copilot to Google Analytics at a glance

FactDetail
Main way to connectThe Ryze AI connector: a hosted MCP server that a Copilot Studio agent takes as a tool. A Microsoft 365 Copilot declarative agent can take it as an action, a route not yet confirmed for Ryze AI
Server addresshttps://connector.get-ryze.ai/mcp, the same for every user
Where it goes in CopilotOn an agent. Classic experience: Tools > Add a tool > New tool > Model Context Protocol. New experience: Build tab > Tools > Add > Model Context Protocol (MCP). No chat window has a documented field for it
Sign-inCopilot signs in to Ryze AI with OAuth 2.0 and Dynamic discovery. Google Analytics is joined once inside Ryze AI with Google sign-in and the read-only analytics.readonly scope, so Copilot never holds a Google token
Google Analytics tools9, all read: 4 AI-traffic tools, 3 report tools, 1 admin-read tool and 1 account list
Can the agent change GA4No. There are no GA4 write tools and the scope is read-only
Properties per questionOne property ID per call, found with the account list tool. Several Google logins can sit in one Ryze AI workspace, each with its own Property
Copilot planMicrosoft's MCP pages name none. A trial cannot publish an agent, and the Copilot Studio for Teams plan lacks generative orchestration and Power Platform connectors
Ryze AI price$89 a month for Paid Ads after a 7-day free trial. The connector itself costs nothing to add
Google's own optionAn open-source analytics-mcp server that your computer runs as a local command, plus a self-hosted HTTP mode since version 1.0.0. Google's pages name Antigravity, Claude Desktop, Claude Code, Cursor and Gemini tools, and no Microsoft Copilot product
Last checkedNovember 14, 2026, from Microsoft and Google pages. 8 read-only GA4 calls ran through the connector from Claude Code that day; no step inside Copilot was run

Before you start

  • A Copilot Studio agent or a Microsoft 365 Copilot declarative agent. This is a builder task, usually done by an agent maker or admin in a work or school tenant. Microsoft says Copilot Studio is open to all Microsoft 365 users for building agents and actions. A trial lets you build and test but not publish, and the sign-up asks for a work or school account.
  • A Copilot Studio plan that carries MCP. Microsoft lists four ways into Copilot Studio: a free user license that an admin assigns once the tenant owns a prepaid Copilot Credit pack, the Copilot Studio authors role, a Microsoft 365 Copilot license, or the trial. Microsoft says MCP access relies on Power Platform connectors, and its licensing page marks both Power Platform connectors and generative orchestration as missing from the Copilot Studio for Teams plan. Whether MCP tools run on the Teams plan is not documented, so test before you promise it.
  • A Google login with access to a GA4 property. The login needs at least the Viewer role on the property. Google describes Viewer as a role that can see settings and data. A role that carries the No Revenue Metrics or No Cost Metrics restriction will not return those metrics through any connector. Universal Analytics properties are not supported, only GA4.
  • 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, and the Google Analytics tools need an active plan or trial.

How to connect Copilot Studio to Google Analytics

Step 1 happens in Ryze AI, steps 2 to 6 in Copilot Studio. The connector URL is the same for every user.

  1. Connect Google Analytics 4 in Ryze AI

    Create a Ryze AI account or sign in, open Integrations in the left sidebar and find Google Analytics 4 under Analytics. Click Connect, sign in to Google and approve access, keeping every requested permission checked. Back in Ryze AI, pick the Property for the workspace (listed as account and property) and click Save. Until a Property is saved the card shows Require setup. Do this before you add the connector to Copilot.

  2. Open the agent and start a new MCP tool

    These steps are for the classic experience (the standard harness). New agents from the Copilot Studio home page run on the Microsoft Copilot harness, so switch first: select the three dots at the bottom of the home page side bar, then Open classic experience, which lasts for the session, or start the agent from Other ways to build. Open your agent and go to its Tools page. Select Add a tool, then New tool, then Model Context Protocol in the Create new section. The MCP onboarding wizard opens, which Microsoft calls the recommended way to add a server.

  3. Fill in the server details

    Server name: Ryze AI. Server description: a plain note on what the tools do, for example Reads Google Analytics 4 traffic, channel, landing page and AI-referral reports. Microsoft says the agent orchestrator uses this description to decide when to call the server. Server URL: https://connector.get-ryze.ai/mcp.

  4. Choose OAuth 2.0 with Dynamic discovery

    Set the authentication type to OAuth 2.0 and the OAuth type to Dynamic discovery. The Ryze AI server supports dynamic client registration, so no client ID, secret or callback URL is typed. Microsoft calls Dynamic discovery the simplest of its three OAuth types. Select Create, then Next.

  5. Create the connection and add the tool

    On Add tool, select Create a new connection and complete the Ryze AI sign-in, or pick an existing connection. Microsoft's page stops at that button and does not show the sign-in window, and this step was not run for this guide. Then select Add to agent.

  6. Ask a Google Analytics question in the test chat

    MCP needs generative orchestration, which Microsoft says is on by default. Open the test chat panel and ask: List the Google Analytics 4 properties my login can read. If the Google Analytics tools do not run, check the troubleshooting list below.

The Ryze AI help center article for Google Analytics 4 covers the Google side of the connection. Microsoft's page on connecting an agent to an existing MCP server covers the Copilot Studio wizard, and its page on switching experiences shows how to open the classic experience. Checked November 14, 2026.

Microsoft 365 Copilot declarative agent

If your colleagues use Microsoft 365 Copilot rather than Copilot Studio, the same URL can go into a declarative agent as an MCP action. Microsoft documents this in its Agents Toolkit walkthrough.

  1. Install Visual Studio Code and Microsoft 365 Agents Toolkit, version 6.12.0 or later.
  2. In the Activity Bar open Agents Toolkit, choose Create a New Agent/App, then Declarative Agent.
  3. Choose Add an Action, then Start with an MCP Server, and paste https://connector.get-ryze.ai/mcp.
  4. Pick OAuth (with dynamic registration) as the authentication type, then a project location and an agent name. No client ID, secret or scopes are asked. Microsoft requires the authorization server to return a client secret at registration; whether the Ryze AI server does that for Microsoft was not checked.
  5. In the Accounts pane sign in to Microsoft 365 and look for Custom App Upload Enabled and Copilot Access Enabled. If either is missing, an admin has to allow custom app upload.
  6. In the Lifecycle pane choose Provision, read the dialog, choose Confirm and wait until the toolkit says provisioning finished.
  7. Open m365.cloud.microsoft/chat, find the agent under Agents in the sidebar (its name ends in dev), ask a Google Analytics question and select the Sign in button that carries the agent's name.

Microsoft says Agents Toolkit sets a new MCP plugin to dynamic tool discovery, so Copilot reads the server's tool list at run time and you add no tools by hand. Sideloading needs Upload custom apps switched on by an admin in the Teams admin center. The first time the agent uses the plugin, Copilot asks the person to allow or cancel. After that, tools that only read do not ask again, and tools that change data do. All 9 Google Analytics tools are read tools.

Sources: Build a plugin for a declarative agent from an MCP server, dynamic client registration for plugins, Microsoft 365 Copilot extensibility requirements, plugin overview. Checked November 14, 2026.

New experience, admin connector and personal Copilot

Microsoft documents more places that accept an MCP address than the two above. Each changes who does the setup and how sign-in works, so find out which one your tenant uses first.

Copilot Studio, new experience

On the Microsoft Copilot harness the server is added from the agent's Build tab: Tools in the components panel, Add beside the search bar, then Model Context Protocol (MCP). The Add MCP server page asks for Name, Description, Server URL and Authentication; select Add, review the tools Copilot Studio lists, then Save. Microsoft labels that how-to page preview, and its Authentication field lists no choices, so the page does not say whether Dynamic discovery is among them. For the Google Analytics tools through Ryze AI, the classic steps above are the documented route.

Getting the agent in front of colleagues

People reach a Copilot Studio agent from Teams and Microsoft Copilot once it has been published at least once and connected to the Teams and Microsoft Copilot channels. A trial license cannot publish, so a trial agent that holds the Google Analytics tools stays in the test chat panel.

Admin route: a custom federated connector

A Global Administrator or AI Administrator can turn an MCP address into a connector in the Microsoft 365 admin center under Copilot > Connectors > Gallery > Create a new connector > Connect to MCP server. People with a Microsoft 365 Copilot license then connect it in Copilot Chat under Settings > Sources. Its sign-in methods are Microsoft Entra SSO, OAuth 2.0 with a client registered by hand in the Teams Developer Portal, or No Auth. Dynamic registration is not listed, and the Ryze AI connector registers clients through its register endpoint, so this route is unconfirmed for Ryze AI.

Copilot with a personal Microsoft account

Copilot on Copilot.com and Copilot Mobile with a personal account has four built-in connectors under Profile > Connectors: OneDrive, Outlook.com, Google Drive, and Gmail with Google Calendar and Contacts. Google Analytics is not among them, Microsoft's support article does not mention MCP or a way to add your own, and so a personal account has no documented place for GA4 through Ryze AI.

Microsoft Copilot and MCP in one table

TopicWhat Microsoft's pages say
Where the address is typedIn an agent or in an admin connector. Copilot Studio: the MCP wizard (classic) or the Add MCP server page (new). Microsoft 365 Copilot: a declarative agent action, a custom federated connector, or a plugin package manifest
Config filesNone named for Copilot Studio, which is set up in the browser. Agents Toolkit writes ai-plugin.json in the agent project, and m365agents.yml holds isPKCEEnabled
Servers on your own computerNo route accepts a start command. Microsoft 365 Copilot must reach the server over the internet, and Microsoft points to a dev tunnel with a public HTTPS address for local work
TransportCopilot Studio takes Streamable and dropped SSE after August 2025. Plugin packages and Cowork expect Streamable HTTP over HTTPS with TLS 1.2 or later
Sign-in, Copilot Studio wizardNone, an API key sent in a header or query parameter you name, or OAuth 2.0 as Dynamic discovery, Dynamic or Manual
Sign-in, declarative agentMicrosoft Entra SSO, dynamic client registration, the OAuth 2.0 authorization code flow or none. API keys are unsupported for MCP plugins, PKCE is on by default, and dynamic registration needs a client secret from the authorization server
Whose account a tool usesIn Copilot Studio a tool uses End user credentials by default, so each person signs in; Maker-provided credentials is the other choice. New-experience connections are saved per agent and per channel
Confirmation before a tool runsCopilot Studio turns on every tool of a new server (Allow all). Declarative agents ask on first use and then before tools that change data. Federated connectors run read tools freely and keep write and delete tools at Needs approval
Plan and billingThe MCP how-to pages name no plan. Agents on the new experience are billed in Copilot Credits, charged for model tokens, the harness and tools, MCP servers included
Where servers are managedClassic: select the server on the Tools page for Details, Tools, Resources and an Enabled toggle. New: the tools list on the Build tab. Declarative agents: Teams > Apps > Manage your apps
Admin controlsA data policy on Power Platform connectors also covers MCP servers. In the Microsoft 365 admin center, Agents > Tools > Registry can block a server, which turns off every tool it exposes

Sources: adding an MCP server in the new experience, MCP in Copilot Studio, MCP tools and resources on an agent, agent tools and credentials, managing tools in the new experience, Teams and Microsoft Copilot channels, Copilot Credits, Copilot Studio access and browsers, plugin sign-in types, MCP servers in plugin packages, custom federated connectors, federated connector approvals, admin tool registry, Copilot connectors for personal accounts. Checked November 14, 2026.

Other AI clients

The same connector URL works in other MCP clients. Ryze AI has separate Google Analytics guides for them:

Google Analytics permissions

Two sign-ins are involved, and each limits what the agent can reach.

Google sign-in saved in Ryze AI
Google OAuth user consent with the read-only analytics.readonly scope plus the basic profile scopes. There is no API key and no service account, and you create no Google Cloud project or OAuth client. The Google login needs at least the Viewer role on a GA4 property.
Ryze AI sign-in from Copilot
The Copilot connection signs in to Ryze AI with OAuth 2.0. In Copilot Studio the tool runs on End user credentials unless the maker changes it, so each person who uses the agent makes a connection of their own. The agent reaches the Property saved in the Ryze AI workspace and the other properties that login can read.
Read-only by design
The Ryze AI connection asks for no edit scope, and the admin-read tool is GET only and rejects create, update and delete paths. No Copilot setting is needed to keep the agent from changing GA4.
Power Platform data policy
Microsoft notes that a data policy on Power Platform connectors also regulates access to the MCP server and its tools. If a policy blocks the connector, ask your Power Platform admin.

Sources: Microsoft's MCP server and data policies note and the Ryze AI Google Analytics 4 integration. Checked November 14, 2026.

Scopes and roles behind the Google sign-in

The Ryze AI connection asks Google for the read-only Analytics scope and the three basic profile scopes. Google's descriptions are quoted in the second column, and the third column says whether Ryze AI requests the scope.

Scope or roleGoogle's descriptionRequested by Ryze AI
analytics.readonlySee and download your Google Analytics data. The runReport method accepts it, and so does the account summaries listYes. The only Analytics scope
openidAssociate you with your personal info on GoogleYes, as a basic profile scope
emailSee your primary Google Account email addressYes, as a basic profile scope
profileSee your personal info, including any personal info you have made publicly availableYes, as a basic profile scope
analytics.editEdit Google Analytics management entitiesNo. Nothing can be created or changed in GA4
analytics.chatbot.readThe scope for the Ask Advisor chat method, different from the one used for standard reportsNo
Viewer roleCan see settings and data, and can change which data appears in reportsThe minimum role the login needs on the property
Marketer and Editor rolesMarketer can create, edit and delete audiences, events and key events; Editor has full control of property settingsNot needed and not used

Which OAuth scopes the Ryze AI connector hands a Copilot connection was not tested. Data restrictions on the Google role apply to every call: Google says restrictions are enforced in the Analytics interface and in the matching API calls.

What each job needs

Because every Google Analytics tool is a read tool, the question is what the Google login can see, not what the agent may change. These rows show which tool each job needs.

What you ask the agent to doTool it needs
Find the property IDs the login can readgoogle_analytics__listAccountSummaries
Run a report with chosen dimensions, metrics and date rangesgoogle_analytics__runRawReport
Cross two dimensions in a pivot tablegoogle_analytics__runPivotReport
See the last 30 minutes of activitygoogle_analytics__runRealtimeReport
Read key events, custom dimensions or audiencesgoogle_analytics__runAdminRead, GET only
See visits that came from ChatGPT, Perplexity and other assistantsgoogle_analytics__getAiTrafficByEngine, getAiTrafficDaily, getAiLandingPages or getAIReferrals
Create or edit a key event, audience or property settingNo tool exists. Do it in GA4 yourself

One Ryze AI workspace can hold several Google logins through Add one more account, each with its own Property, and one of them is the primary the agent uses by default. Tools take an optional connection_id to target one account. The help center advises one workspace per business and a separate workspace for each client.

Out of reach on the default connection: any change to GA4, Universal Analytics properties, revenue or cost metrics that the Google role hides, and properties the login has no role on. Realtime reports reach only the last 30 minutes.

Sources: Google OAuth scope list, Google Analytics roles and data restrictions, runReport reference, accountSummaries.list reference. Checked November 14, 2026.

Removing access

To take Google Analytics away from a Copilot Studio agent, open its Tools page in the classic experience, hover over Ryze AI, select the three dots and Delete; to pause it instead, open the server, switch Enabled off and Save. In the new experience, select the X next to the server on the Build tab and then Remove. A sideloaded declarative agent is managed in Teams under Apps > Manage your apps. To stop Ryze AI reaching GA4, disconnect Google Analytics 4 under Integrations in Ryze AI, and remove Ryze AI from the third-party access list of your Google Account if you want the grant gone on Google's side too.

What Copilot can do in Google Analytics

The Ryze AI connector exposes 9 Google Analytics tools, all read tools. A Copilot agent calls them through the Google login you connected. All 9 names were loaded by exact name from the live connector on November 14, 2026. Copilot Studio adds the whole server as one tool and switches every tool on through Allow all; turn Allow all off to switch single tools off.

ToolTypeWhat it does
google_analytics__getAiTrafficByEngineReadReturns traffic from AI referrers grouped by source engine and compared with a prior period, for one GA4 property.
google_analytics__getAiTrafficDailyReadReturns daily traffic from AI referrers such as ChatGPT and Perplexity for one GA4 property.
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.
google_analytics__runRawReportReadRuns a GA4 Data API runReport with chosen dimensions, metrics, named date ranges, filters and ordering, and pages through the results.
google_analytics__runRealtimeReportReadRuns a GA4 Data API realtime report covering the last 30 minutes.
google_analytics__runPivotReportReadRuns a GA4 Data API pivot-table report.
google_analytics__runAdminReadReadReads a GA4 Admin API resource such as key events, custom dimensions or audiences. GET only; it cannot write.
google_analytics__listAccountSummariesReadLists the GA4 accounts and properties the connected Google login can access, so the agent can find property IDs.

No Google Analytics tool changes anything, so an approval prompt guards only what the agent reads. In the classic experience, the Allow all switch above is how you switch single tools off. Microsoft describes a per-tool setting, Ask the end user before running, that defaults to No, but it does not say the setting shows for an MCP server, so look for it on the Ryze AI tool. The new-experience pages describe only on and off switches. A Microsoft 365 declarative agent asks on first use and then before tools that change data. The Ryze AI chat has its own Tool approvals picker that starts on Skip all approvals and can be set to Approve write & delete or Manual approve.

Limits in numbers

Three parties set limits on this route: Google's Data API, the Ryze AI tools and Copilot. Google counts most quota per property. The three report-size caps (9, 10 and 4) come from the test calls above; Google's pages opened for this guide print the 9-dimension cap but not the other two.

LimitFigure or ruleSet by
Daily tokens200,000 per property per day on a standard property, 2,000,000 on Analytics 360Google
Hourly tokens40,000 per property per hour on standard, 400,000 on 360. Per Google Cloud project per property per hour: 14,000 on standard, 140,000 on 360Google
Concurrent requests10 per property on standard, 50 on 360Google
Cost of one requestGoogle says most requests charge 10 tokens or fewer. More rows, more dimensions and metrics, complex filters, long date ranges and high-cardinality dimensions such as pagePath cost more. The one-day, one-metric test report cost 1 tokenGoogle
When quota runs outA bucket at 0 answers 429 RESOURCE_EXHAUSTED. Daily quotas refresh at midnight Pacific time and hourly quotas within an hourGoogle
Server errors10 per project per property per hour on standard, 50 on 360. When that is used up, every request from the project to the property is blocked. A separate window allows 10,000 failed requests per project per property in 15 minutesGoogle
Realtime reportsTheir own quota with the same figures as core. The window is the last 30 minutes, up to 60 on 360 propertiesGoogle
Demographic dimensions120 potentially thresholded requests per property per hour, for dimensions such as userAgeBracket and userGenderGoogle
Rows per report10,000 rows if you give no limit, and at most 250,000 per request. Larger results are paged with offsetGoogle
Dimensions, metrics, date ranges9 dimensions, 10 metrics and 4 date ranges per report, as the API answered in the testGoogle API, tested
Data delayOn standard properties intraday data typically arrives in 2 to 6 hours and daily data in 12 hours. Processing can take 24 to 48 hours, and report data may change in that timeGoogle
Data retentionUser-level data is kept 2 or 14 months, and other event data 2 or 14 months on standard properties. The setting affects explorations and funnel reports, not standard aggregated reportsGoogle
Admin API1,200 requests per minute, 600 per user per minute. The write quotas are unused because the Ryze AI tools only readGoogle
Ryze AI tool inputsgetAiLandingPages takes a limit of at most 200 rows. runRawReport defaults to 10,000 rows and pages with offset. A property ID is 1 to 64 characters, and the runAdminRead path is up to 512Ryze AI
Tools on a Copilot Studio agentUp to 128 with generative orchestration, and Microsoft suggests 25 to 30. The Ryze AI server is added as one tool; Microsoft does not say whether the 9 Google Analytics tools inside it count toward 128Microsoft, classic experience
MCP servers in one conversationAn agent can hold several, but only a capped number run in one conversation and the rest are skipped for that turn. Microsoft gives no figureMicrosoft, new experience
Plugins in a declarative agentUp to 5 plugins always go into the prompt, and answers may get worse above 10 tools in one plugin. The 9 Google Analytics tools sit just under thatMicrosoft 365 Copilot
Tool call time in plugin packagesA tool call should finish in under 30 seconds, which matters for a wide report. Microsoft names this for plugin packages and CoworkMicrosoft
Tool list after a changeCopilot Studio picks up server changes by itself. After a custom connector is republished, tool changes can take about 12 to 24 hours to show, with no manual refreshMicrosoft

Sources: Data API quotas, Data API changelog, realtime reports, Create a report, Admin API quotas, data freshness, data retention, Copilot Studio tool limits, MCP servers per conversation, declarative agent plugin limits, Copilot Studio MCP troubleshooting, tool call time in plugin packages, Ryze AI Google Analytics 4 integration. Checked November 14, 2026.

Tested calls

These calls ran on November 14, 2026 through the Ryze AI connector from Claude Code against a standard GA4 property in a Ryze AI test workspace, not from Copilot. No account name, property ID or metric value is shown here.

CallResult
listAccountSummariesWorked. Returned account summaries, each with property summaries carrying the property, display name, property type, parent and canEdit fields
runRawReport, one day, one metric (sessions), property quota requestedWorked. One row came back with metric headers, a row count, the currency code and time zone, and a propertyQuota block whose totals equal Google's standard-property limits. The request cost 1 token
runRawReport with a dimension name that does not existRefused with 400 INVALID_ARGUMENT and a suggestion of the closest name
runRawReport with a metric name that does not existRefused with 400 INVALID_ARGUMENT and a suggestion of the closest name
runRawReport with a property ID that does not existRefused with status not_allowed and a permissions message
runRawReport with 10 dimensionsRefused with 400 INVALID_ARGUMENT: the limit is 9
runRawReport with 11 metricsRefused with 400 INVALID_ARGUMENT: the limit is 10
runRawReport with 5 date rangesRefused with 400 INVALID_ARGUMENT: the limit is 4

First 3 prompts to run

Each answer comes from your own GA4 property, so this page describes what comes back and shows no sample numbers. Add the prompts to the agent's instructions or paste them into the test chat.

1. Channels, this month against last month

For the property I saved in Ryze AI, report sessions, key events and revenue by default channel group for last month against the month before, with each date range named.

Tools used: google_analytics__runRawReport

What comes back: One row per default channel group with the three metrics for each named range. Revenue shows as zero unless ecommerce tracking and purchase events are set up in GA4.

2. Top landing pages for the last 28 days

List the top landing pages by sessions for the last 28 days with engagement rate and key event rate.

Tools used: google_analytics__runRawReport

What comes back: A table of landing pages with sessions and the two rates, from your own property.

3. Which AI assistants send visits

Which AI assistants sent visits in the last 30 days compared with the 30 days before, and which landing pages did they reach?

Tools used: google_analytics__getAiTrafficByEngine and google_analytics__getAiLandingPages

What comes back: Visits by source engine against the prior period, then the landing pages that receive AI-referred traffic. GA4 reports visits that arrive from assistants; it does not measure whether an assistant mentions your brand.

Ryze AI has not tested this connection in Copilot Studio or Microsoft 365 Copilot. The steps follow Microsoft's documentation and the connector's OAuth metadata, which supports dynamic client registration. Report anything that differs to Ryze AI support.

10 jobs to hand to a Copilot agent

Ten jobs a Copilot agent with the Ryze AI tool can take on, each matched to its tool. The last column says whether the default read-only connection covers it and how it was checked. Nothing was run from Copilot.

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 through the connector from Claude Code on November 14, 2026
Channel reportShow sessions, key events and revenue by default channel group for last month against the month before.google_analytics__runRawReportYes. The tool ran in the same test; up to 4 date ranges, 9 dimensions and 10 metrics per report
Landing pagesShow the top landing pages by sessions with engagement rate and key event rate for the last 28 days.google_analytics__runRawReportYes. The tool ran in the test
Revenue by sourceShow purchase revenue and purchases by source and medium.google_analytics__runRawReportYes, but revenue reads as zero without ecommerce tracking and purchase events, and a No Revenue Metrics role hides it. Not run
PivotPivot sessions by channel across device categories.google_analytics__runPivotReportYes. Read tool, not run in the test
Live viewShow who is on the site right now by country and device.google_analytics__runRealtimeReportYes, for the last 30 minutes only. Not run in the test
Setup auditList the key events, custom dimensions and audiences configured in the property.google_analytics__runAdminReadYes, GET only. Not run in the test
AI traffic by engineWhich AI assistants sent visits in the last 30 days, compared with the 30 days before?google_analytics__getAiTrafficByEngineYes. Read tool, not run in the test
AI traffic trendShow the daily trend of visits from AI assistants such as ChatGPT and Perplexity.google_analytics__getAiTrafficDailyYes. Read tool, not run in the test
AI referrals and pagesShow each AI referral source with sessions and conversions, and the landing pages that receive AI-referred visits.google_analytics__getAIReferrals and google_analytics__getAiLandingPagesYes. Read tools; landing pages up to 200 rows. Not run in the test

6 ways to connect Microsoft Copilot to Google Analytics

Six ways can bring Google Analytics into a Microsoft Copilot agent. This guide uses the Ryze AI connector as the main way: Copilot Studio's wizard takes its address with Dynamic discovery, the Google sign-in stays inside Ryze AI, and no Google credentials are pasted into Copilot. None of the six was run inside Copilot for this guide. The setup column says how each one is meant to reach an agent.

WayRuns whereSetup in CopilotWhat it reaches in GA4Price
Ryze AI connector (the main way)Hosted by Ryze AI at one address for every userCopilot Studio: MCP wizard with the connector URL and OAuth 2.0 Dynamic discovery, then Create a new connection. Microsoft 365 Copilot: a declarative agent action with OAuth (with dynamic registration), not confirmed for Ryze AI9 read tools: reports, pivots, realtime, admin reads, account list and 4 AI-traffic tools. No GA4 writesPaid Ads $89 a month after a 7-day free trial; SEO Starter $129 a month; Agency $279 a month
Google's analytics-mcp serverOpen source from Google, version 1.1.0 published November 6, 2026. By default a local command (pipx run analytics-mcp). Since 1.0.0 it can also run with --transport http on infrastructure you host, with an optional built-in OAuth 2.1 serverCopilot Studio has no field for a start command, so the local mode does not fit. The HTTP mode needs a public HTTPS host you run, and Google's pages name no Microsoft Copilot product for it. Whether Copilot Studio completes its sign-in was not checkedDocs page lists 9 read tools; the README lists 13, including 3 opt-in write tools behind --allow-write and the analytics.edit scope. Read-only by default. You need Python 3.10 or higher, a Google Cloud project with two APIs enabled and the Viewer roleNo price stated, Apache-2.0 licence. You pay for whatever hosts it. The README says the built-in OAuth provider keeps sessions in memory, so restarts require re-authentication
Google-hosted Data API endpointGoogle's servers, at https://analyticsdata.googleapis.com/mcp/v1Unverified. Google's reference page for it returned 404 on November 14, 2026, while a Markdown copy loaded, and Google Cloud's list of remote MCP servers does not include Google Analytics. Google says its remote MCP servers do not support Dynamic Client Registration, so connecting needs your own Google credentials. Treat it as not announced4 read tools in the Markdown reference: run_report, get_metadata, run_realtime_report, check_compatibilityNot stated
Windsor.ai (Windsor MCP)Hosted by Windsor.ai; GA4 is a data source and Windsor MCP the destinationWindsor lists a Copilot guide among its setup guides. Which Copilot product it covers, and the steps, were not checkedRead-only access to GA4 data. The connector lists 19 tools in total, and no count is given for GA4 aloneForever Free after a 30-day trial: 1 user, 1 data source, 1 account, data from the past 30 days. Basic is $23 per month, or $19 per month billed yearly
Coupler.ioHosted export service that syncs GA4 data on a schedule; the AI queries the synced copy, not GA4Coupler.io lists Copilot and a Custom MCP option among its AI integrations. You build a GA4 data flow first, then connect the destination. That pairing was not triedRead-only. A data flow carries up to 10 metrics and 9 dimensions, and refreshes on a scheduleFree plan: 1 account, 1 source, 1 destination, manual refresh. Starter is $32 per month, or $24 billed yearly
ComposioHosted by Composio at https://connect.composio.dev/mcp over Streamable HTTP, the transport Copilot Studio acceptsAdd the address, then authenticate with Composio's managed Google OAuth app. Composio's per-assistant pages do not name Microsoft Copilot, so the Copilot route was not checkedThe toolkit page lists 82 tools, including writes such as Create AudienceFree $0 with 10,000 tool calls a month. Standard is $18 per seat per month

With a hosted way your GA4 data passes through that vendor, and Microsoft says you are responsible for the tools and resources you reach through a non-Microsoft MCP server in Copilot Studio. Composio's toolkit page also says its free plan includes 100,000 tool calls a month, which differs from its pricing page; the pricing page figure is used here.

Options that do not fit a Copilot agent

  • Zapier MCP. Zapier's GA4 page lists 6 actions, among them Run Report for a Property, Create Conversion Event for a Property and Send Measurement Events. Each successful tool call uses 2 tasks from your Zapier plan. Its pages name Claude, ChatGPT, Cursor and Codex among popular clients and do not name Microsoft Copilot.
  • The open-source surendranb/google-analytics-mcp. A local process that the assistant starts (uvx google-analytics-mcp), with 8 read tools and a service account file. Copilot Studio has no field for a start command, so it does not fit a Copilot agent.
  • Google's Analytics agent skills. Instruction files that help a coding agent write Data API code. They carry no data connection and name Antigravity, Claude Code, Codex and Cursor, so they do not answer a question inside Copilot.
  • Ask Advisor chat method. A v1alpha Data API method, added September 14, 2026, that sends a question to the assistant inside Google Analytics. It is a route for code that needs its own OAuth scope, not a connector you add to a Copilot agent.
  • A custom federated connector pointed at Ryze AI. This is the admin route in the section on other Copilot surfaces. None of its three sign-in methods is dynamic registration, which is how the Ryze AI connector signs clients up, so it stays unconfirmed for Ryze AI.

Which one to pick

Pick the Ryze AI connector when one Copilot Studio agent should read GA4 reports, AI-assistant traffic and property settings without any Google Cloud setup. The caveats are that the route has not been run inside Copilot, that it needs a Ryze AI plan once the trial ends, and that it can only read. Pick Google's analytics-mcp server in HTTP mode if you can host a public HTTPS service and want Google's own open-source code, and accept that its pages name no Microsoft Copilot product and that the in-memory sign-in state ends on restart. Windsor.ai and Coupler.io suit teams that want GA4 beside other sources or a synced copy, and Composio is a hosted option whose Copilot route is untested.

Sources: Try the Google Analytics MCP server, googleanalytics/google-analytics-mcp, analytics-mcp on PyPI, Data API MCP reference (Markdown copy), Google Cloud MCP authentication, Google Cloud remote MCP servers, Analytics agent skills, Ask Advisor chat method, Windsor.ai GA4 MCP, Windsor.ai pricing, Coupler.io Google Analytics MCP, Coupler.io pricing, Composio Google Analytics toolkit, Composio pricing, Zapier MCP for GA4, surendranb/google-analytics-mcp, Copilot Studio MCP guide, third-party MCP servers in Copilot Studio, custom federated connectors, Ryze AI Google Analytics 4 integration. Checked November 14, 2026.

Copilot, Google Analytics and MCP: dates that matter

DateWhat happened
March 19, 2025Microsoft announced MCP support in Copilot Studio. The first release used the SSE transport; a later post calls it a public preview.
May 29, 2025MCP in Copilot Studio reached general availability, with the tool list on the server settings page, streamable transport and tracing of which server and tool ran.
July 30, 2025The Google Analytics team announced its MCP server in the Google Analytics API Notify group: it lets you connect your Analytics data to an LLM such as Gemini.
August 2025Copilot Studio stopped supporting SSE for MCP; Streamable is the only supported transport. Microsoft gives no exact day.
August 22, 2025analytics-mcp 0.1.0, the first release on PyPI and GitHub.
December 15, 2025Microsoft announced general availability of MCP in declarative agents for Microsoft 365 Copilot, built in Agents Toolkit with Add Action, Start with an MCP server.
September 2, 2026A Microsoft Copilot blog post announced general availability of the GitHub Copilot harness in Copilot Studio, since renamed the Microsoft Copilot harness, with MCP servers as tools. Microsoft's how-to page for adding a server on that harness still carries a preview label.
September 14, 2026Google's Data API changelog added conversational query support in v1alpha, the Ask Advisor chat method.
October 22, 2026analytics-mcp 0.8.0 added the first write tool, the --allow-write flag and tool annotations.
October 27, 2026The Microsoft 365 Copilot release notes list, under this date, admins creating custom MCP connectors in the Microsoft 365 admin center. Microsoft's roadmap item gives an earlier availability month, February 2026.
November 3, 2026analytics-mcp 1.0.0 added a multi-tenant Streamable HTTP transport and OAuth 2.1 support, and left experimental status.
November 6, 2026analytics-mcp 1.1.0 added Dockerfile and Cloud Run deployment docs and opt-in Admin API write tools. 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.

Sources: Microsoft Copilot blog, March 19, 2025, Microsoft Copilot blog, May 29, 2025, SSE support ended after August 2025, Microsoft 365 Developer Blog, December 15, 2025, Microsoft Copilot blog, September 2, 2026, adding an MCP server in the new experience, Microsoft 365 Copilot release notes, Microsoft 365 roadmap item 501585, Google Analytics API Notify, July 30, 2025, analytics-mcp releases, Data API changelog, Try the Google Analytics MCP server. Checked November 14, 2026.

How this guide was tested

Eight read-only Google Analytics calls ran through the Ryze AI connector on November 14, 2026, from Claude Code, against a standard property in a Ryze AI test workspace. That checks the tools and the Google side. It does not check anything inside Copilot.

What was runWhat came back
The 9 Google Analytics tool definitionsLoaded by exact name from the live connector; all 9 matched the Ryze AI facts, and no name contains a write verb.
Account list and one reportBoth worked. The single-metric report returned one row plus a propertyQuota block.
Five deliberately wrong reportsA bad dimension, a bad metric, an unknown property, 10 dimensions and 5 date ranges were each refused; see the errors below.
The connector's authorization server and protected resource filesRequested once each on the same day for their client authentication methods and HTTP status. No client was registered and no sign-in was started.
Microsoft's Copilot Studio and Microsoft 365 Copilot pagesRead on the same day for every setup step, limit, plan note and date used here.
Google's Analytics docs, quota, scope and release pages, plus vendor pagesRead on the same day for every Google figure, date and the comparison. Tool counts and prices are as the pages printed them.

Not run for this guide: anything inside a Microsoft product. No Copilot Studio agent was created, no MCP tool was added, no Agents Toolkit project was built, no admin center connector was set up, and no Ryze AI sign-in happened from Copilot. Also not run: runPivotReport, runRealtimeReport, runAdminRead and the four AI-traffic tools, because they would return business data from a real account; and any authenticated call to Google's own MCP server or hosted endpoints. Those steps follow Microsoft's and Ryze AI's documentation as read on November 14, 2026.

Errors and fixes

The first six messages were captured from the November 14, 2026 test calls, which ran from Claude Code, so the wording reaching a Copilot agent may differ. The last two come from Google's error documentation and were not triggered.

There is no place to paste the URL in Copilot chat
Microsoft's pages show no field for an MCP address in a Copilot chat window. Add the URL as a tool on a Copilot Studio agent or build a declarative agent in Agents Toolkit. An admin can also create a custom federated connector in the Microsoft 365 admin center, but that route was not confirmed for Ryze AI.
The Tools page or the New tool button is missing
The agent runs on the new experience, where tools sit on the Build tab. Open the classic experience from the three dots at the bottom of the home page side bar, or create the agent with Other ways to build.
I cannot publish the agent
A Copilot Studio trial lets you create and test agents but not publish them. Use the test chat panel, or move to a plan that can publish.
Model Context Protocol or connectors are missing on the Teams plan
The Copilot Studio for Teams plan does not include Power Platform connectors or generative orchestration, and MCP access relies on connectors. Ask your admin about a standalone Copilot Studio subscription.
The connector is blocked
A Power Platform data policy that regulates connectors also regulates the MCP server, and a blocked tool shows as disabled in the Add tool panel. Ask your Power Platform admin to allow it. A tool that an organization policy limits to certain people may also wait for an admin to approve the request under Agents > Tools > Requests in the Microsoft 365 admin center.
Agents Toolkit says Custom App Upload is not enabled
Sideloading needs Upload custom apps turned on by an admin in the Teams admin center. Ask your admin, then reload the Accounts pane.
The declarative agent sign-in fails
Microsoft's dynamic registration for declarative agents needs the authorization server to issue a client secret, and registration without one is not supported yet. This was not checked for the Ryze AI server, so use the Copilot Studio route if the sign-in does not complete.
The agent never calls the Google Analytics tools
Microsoft says the orchestrator uses the server description to decide whether to call the server. Rewrite the description to say what the tools do, such as reading GA4 channel and landing page reports, and check that generative orchestration is on.
The tools return a subscription message or no data
The Google Analytics tools need an active Ryze AI plan or free trial, and Google Analytics 4 must show as connected, with a Property saved, under Integrations in Ryze AI. If the connector was added before GA4 was connected, remove it from the agent, add it again and start a new test chat.
Did you mean manualSource? Field trafficSauce is not a valid dimension.
400 INVALID_ARGUMENT. The dimension name does not exist; the test sent a wrong one on purpose. Ask again with a real dimension 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; the current one is keyEvents.
User does not have sufficient permissions for this property.
Returned as status not_allowed. The property ID does not exist or the connected Google login has no role on it, and Google gives the same answer in both cases. Ask for listAccountSummaries to get the IDs the login can read, or ask a property admin for the Viewer role.
Requests are limited to 9 dimensions within a nested request.
400 INVALID_ARGUMENT, here for 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, here for an 11-metric request. Ask for 10 metrics or fewer per report.
Requests are limited to 4 dateRanges.
400 INVALID_ARGUMENT, here for 5 ranges. Compare up to 4 periods per report, or use a date dimension over one longer range.
429 RESOURCE_EXHAUSTED
From Google's error documentation, not triggered: the property's token quota is used up. Daily quotas refresh at midnight Pacific time and hourly quotas within an hour.
401 UNAUTHENTICATED
From Google's error documentation, not triggered: the request lacks valid credentials. Reconnect Google Analytics 4 under Integrations in Ryze AI, keeping every permission checked.
Revenue is zero
GA4 returns revenue only when ecommerce tracking and purchase events are set up, and a role with the No Revenue Metrics restriction hides it.
I need a second GA4 account
Several Google logins can be connected to one workspace with Add one more account, each with its own Property. Tools accept an optional connection_id to target one.

Sources: Data API errors, Data API quotas, property ID, Copilot Studio MCP troubleshooting. Checked November 14, 2026.

Terms on this page

MCP (Model Context Protocol)
An open standard through which an AI model reaches outside data and applications. Copilot Studio adds an MCP server to an agent as a tool, and Google publishes an MCP server for Analytics too.
Classic and new experience
The two ways Copilot Studio builds agents. Microsoft's pages call the classic one the standard harness and the new one the Microsoft Copilot harness. The setup steps in this guide use the classic one.
Dynamic discovery
A Copilot Studio OAuth 2.0 option for servers that support dynamic client registration: Copilot Studio finds the sign-in endpoints and registers itself, so nobody types a client ID.
Declarative agent
A Microsoft 365 Copilot agent built from a manifest, here in Agents Toolkit, that can carry an MCP server as an action.
Property and property ID
The unit of Google Analytics that reports are produced for. Every Data API request names its numeric property ID, shown under Admin, Property settings. Only GA4 properties work, not Universal Analytics.
Key event
Google calls it an event that measures an action particularly important to the success of your business. It was formerly called a conversion; the API metric is keyEvents and conversions is the deprecated name.
Dimension and metric
Metrics are individual measurements such as active users or event count. Dimensions break them down by criteria such as country or event name.
Default channel group
Google's rule-based grouping of traffic sources. In the API it is the dimension sessionDefaultChannelGroup, with values such as Direct, Organic Search, Paid Search and Referral.
Token (Data API quota)
The unit Google charges for each report request. A standard property has 200,000 per day and 40,000 per hour.
Viewer role
The lowest GA4 role that lets a login read data, and the minimum the Ryze AI connection needs.

Sources: Google Analytics MCP server, Copilot Studio experiences, Dynamic discovery, declarative agents with MCP, property ID, key events, default channel group, dimensions and metrics, Viewer role. Checked November 14, 2026.

Frequently asked questions

How to connect Copilot to Google Analytics?

Ryze AI is the best way to connect Microsoft Copilot to Google Analytics for an agent that should read GA4 reports and AI-assistant traffic, though it has not been run inside Copilot, needs a Ryze AI plan or trial and cannot write to GA4. Connect Google Analytics 4 in Ryze AI, then add https://connector.get-ryze.ai/mcp as a Model Context Protocol tool on your Copilot Studio agent with OAuth 2.0 and Dynamic discovery, select Create and Next, and create the connection.

Is there a Google Analytics connector for Copilot?

Microsoft's pages list no Google Analytics connector, and Google's setup pages name no Microsoft Copilot product. Copilot Studio can add an existing MCP server as a tool, and the Ryze AI connector is a hosted server you can add that way. Copilot Studio's MCP tab lists servers already published in your organization; that list needs a signed-in tenant and was not opened for this guide.

Is there a Copilot Google Analytics MCP server I can use?

Two can be tried. The Ryze AI connector at https://connector.get-ryze.ai/mcp gives an agent 9 read-only Google Analytics tools. Google's own analytics-mcp is open source and runs as a local command by default, with an HTTP mode you host yourself; its pages name Antigravity, Claude Desktop, Claude Code, Cursor and Gemini tools, not Microsoft Copilot. Neither was run inside Copilot for this guide.

Can I add a Google Analytics connector in Microsoft 365 Copilot without Copilot Studio?

Microsoft documents routes that skip Copilot Studio: a developer can add the connector URL as an action in a declarative agent built with Agents Toolkit, or an admin can create a custom federated connector in the Microsoft 365 admin center. The declarative agent route needs a client secret from dynamic registration, which was not checked for Ryze AI, and the admin route lists no dynamic registration, so neither is confirmed for the Ryze AI connector.

Can I paste an MCP URL into the Copilot chat app?

No. None of Microsoft's pages shows a Copilot chat window that takes an MCP address. The URL goes in Copilot Studio on an agent's Tools page or Build tab, in a declarative agent built with Microsoft 365 Agents Toolkit, or in an admin's custom federated connector that people then turn on under Settings > Sources.

Which Copilot plan do I need?

Microsoft says Copilot Studio is available to all Microsoft 365 users for creating agents and actions. A trial can create and test but not publish. The Teams plan lacks Power Platform connectors, which MCP access relies on, so plan for a standalone Copilot Studio subscription. For Microsoft 365 Copilot declarative agents an admin must allow custom app upload.

What Google Analytics permissions do I need?

A Google login with at least the Viewer role on a GA4 property. Ryze AI requests only the read-only analytics.readonly scope plus basic profile scopes, and you keep every requested permission checked on the Google screen. You create no API key, service account or Google Cloud project.

Can Copilot change my Google Analytics settings?

No. All 9 Google Analytics tools are read tools, there are no GA4 write tools, and the admin-read tool is GET only. Copilot cannot create or edit properties, key events or audiences through Ryze AI.

Does the Ryze AI connector work with Copilot Studio?

The connector is a remote MCP server with OAuth that supports dynamic client registration, which matches Microsoft's Dynamic discovery option. Ryze AI has not tested it in Copilot Studio or Microsoft 365 Copilot, so try it on a property you can afford to experiment with. The 9 tools themselves were checked through Claude Code on November 14, 2026.

Can I connect more than one Google Analytics property or account?

Yes. Several Google logins can be connected to one Ryze AI workspace with Add one more account, each with its own Property, and one is the primary the agent uses by default. Other properties stay reachable by naming them in chat, and tools accept an optional connection_id. How a Copilot connection picks a workspace was not tested.

Can it show traffic from ChatGPT and Perplexity?

Yes. 4 of the 9 tools report visits from AI assistants 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 those assistants; it does not show whether an assistant mentions your brand.

Which transport does Copilot Studio support?

Microsoft says Copilot Studio supports the Streamable transport for MCP and no longer supports SSE after August 2025.

How much does it cost?

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. Copilot Studio licensing is set by Microsoft, and Google Analytics has its own pricing.

How do I disconnect Google Analytics from Copilot?

Remove the Ryze AI tool from the agent in Copilot Studio. To cut Ryze AI off from GA4, disconnect Google Analytics 4 under Integrations in Ryze AI, and remove the Ryze AI grant from your Google Account if you want it gone on Google's side.

Connect Google Analytics to your Copilot agent

Connect Google Analytics 4 once in Ryze AI with Google sign-in, then add the MCP URL to your agent. 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 or email Ryze AI support.