Google Analytics MCP Server ChatGPT Setup: GA4 Step by Step

InsightfulPipe publishes this guide, and its steps use InsightfulPipe's hosted Google Analytics 4 server. Google's own server and the other routes are covered too, with what each one needs.

Last updated: 2026-11-01

Short answer: InsightfulPipe runs a hosted Google Analytics MCP server ChatGPT can add with one URL. Connect GA4 in InsightfulPipe, then in ChatGPT go to Plugins, click Add, choose Add custom MCP server and paste https://google-analytics.insightfulmcp.com/. Sign in to InsightfulPipe if asked and click Authorize access. Google's official server runs on your own computer, so ChatGPT on the web cannot add it as it ships. Plans start from $29.99 a month.

Google Analytics MCP server ChatGPT setup: the quick version

Six steps take you from a Google sign-in to a first GA4 answer in ChatGPT, through InsightfulPipe's hosted Google Analytics MCP server. Each step has its own section below, with the labels you will see on screen.

1. In InsightfulPipe, open Connected accounts, click Connect account and choose Google Analytics 4.
2. Pick Read-only or Read & write, click Continue with Google Analytics 4 and select your properties.
3. In ChatGPT, go to Plugins, click Add, then Add custom MCP server.
4. Name it, paste https://google-analytics.insightfulmcp.com/ under Connection, keep OAuth, tick I understand and want to continue and click Create as a plugin.
5. When the sign-in opens, sign in to InsightfulPipe if asked, and click Authorize access.
6. In a new chat, type @ and pick the plugin.

Want every platform you connected, not only GA4? Install InsightfulPipe from the ChatGPT Plugins directory instead of steps 3 and 4. It connects the full InsightfulPipe MCP server in one click.

Watch: Connect GA4 to ChatGPT with the InsightfulPipe Google Analytics 4 MCP server (2 min 16 s)

The video shows an earlier version of ChatGPT's setup screens. Follow the steps in this article for the current route.

Can ChatGPT use Google's official Google Analytics MCP server?

Not as it ships. Google's server is a local program that your computer starts, and ChatGPT on the web connects only to servers it can reach over the internet. You can bridge that gap yourself, and this section lists what it takes, from Google's and OpenAI's own guides.

• Read-only, by Google's guide. Google's guide, updated 2026-10-26, says the server "is available for read requests only. It can't create, modify, or delete your Google Analytics configuration or settings." It lists nine tools, from get_account_summaries to run_conversions_report.
• One opt-in write, by its repository. Version 0.8.0 of google-analytics-mcp, released 2026-10-22, adds create_property_annotation behind an --allow-write flag and the analytics.edit scope.
• What it needs. Python 3.10 or later, pipx or uv, a Google Cloud project with the Analytics Admin and Data APIs switched on, the Viewer role or higher on the property, and Application Default Credentials from the gcloud CLI.
• An HTTP mode, not yet released. On 2026-11-02 Google merged a Streamable HTTP mode with a built-in OAuth server into the repository's main branch. No release includes it yet, and you still host it with your own Google OAuth client.
• Clients in Google's guide. Antigravity, Claude Desktop, Claude Code and Cursor. The guide has no ChatGPT steps.

OpenAI documents two ways to reach a server like this. You can put it behind a public HTTPS address that you build and secure. Or you can use OpenAI's Secure MCP Tunnel: a tunnel ID and an API key from the OpenAI Platform, tunnel permissions, and tunnel-client running beside the server whenever ChatGPT needs it.

Google's list of managed MCP servers, updated 2026-10-30, has no Google Analytics entry, so Google documents no hosted GA4 server to add instead. Behind a host or a tunnel, the server still reads GA4 apart from annotations, and someone keeps it running. InsightfulPipe runs hosted, joins ChatGPT with one URL or one click, and changes GA4 settings within switches your admin sets per property.

What you are actually connecting

You connect ChatGPT to InsightfulPipe's hosted Google Analytics MCP server, and that server to the GA4 properties you authorize, on one path.

ChatGPT → InsightfulPipe GA4 MCP server → the GA4 properties you authorized

ChatGPT never sees your Google password. It sends a request over the Model Context Protocol (MCP), and InsightfulPipe calls the Google Analytics Data API or Admin API with the access you approved. Reports run through query_data, which tells ChatGPT it only reads. Changes run through a separate tool, execute_action. That split is how MCP differs from calling the API yourself.

Two approval layers sit on that path. In ChatGPT, the plugin's Permissions decide when ChatGPT asks before it uses a tool, and OpenAI says write actions "by default require confirmation". InsightfulPipe adds a switch on every GA4 action, set per property by your admin.

The access level also sets Google's scope. Read-only asks Google for analytics.readonly, and Read & write adds analytics.edit. You need no Google Cloud project, OAuth client, server to host or tunnel to run.

Before you connect GA4 to ChatGPT

You need four things before the first click, and the roles on both sides decide what ChatGPT can do.

• GA4 access. A Google login that can open the property in Google Analytics.
• An InsightfulPipe workspace. Plans start from $29.99 a month, and Starter includes 8 connections. Each GA4 property counts as one. Start a trial from the pricing page.
• A role that can connect. Owners, Administrators and Operators connect accounts and set their actions. See workspace roles and permissions.
• ChatGPT on the web. You add custom MCP servers in ChatGPT on the web, and OpenAI says workspace permissions and security restrictions apply. Our ChatGPT setup guide covers both routes.

Google's own roles still apply. In Google's role list, a Viewer "can see settings and data", a Marketer "can create, edit, and delete audiences, events, and key events", and an Editor has "full control of settings at the property level". InsightfulPipe cannot expand the authority of the Google login you connect.

Step 1: Connect Google Analytics 4 in InsightfulPipe

Step 1 links your GA4 properties to your InsightfulPipe workspace. You choose how far ChatGPT may go before Google asks you to sign in.

1. Open Connected accounts and click Connect account.
2. In Add an integration, find Google Analytics 4 and click Connect.
3. Under Access level, choose Read-only or Read & write.
4. Check the Agent actions list below it. On Read & write it shows All 50/62, with Destructive 0/12.
5. Click Continue with Google Analytics 4, then sign in with Google and approve access.
6. Under Properties, pick your properties and click Connect 1 property, or the count you picked.

Each property becomes its own connection with its own action list. On Read-only, the list shows All 26/62, with every write and destructive action locked. A read-only connection locks every write until an admin reconnects it with Read & write. The GA4 connector docs cover each field.

Step 2 (fastest): Install InsightfulPipe from the ChatGPT Plugins directory

The directory listing is the one-click route. It connects the full InsightfulPipe server, so ChatGPT reaches GA4 and every other platform your workspace connected, through one sign-in.

1. In ChatGPT on the web, open Plugins.
2. Search for InsightfulPipe and open its listing, or click Open in ChatGPT on the GA4 MCP page.
3. Click Install plugin.
4. Sign in to InsightfulPipe if asked, then click Authorize access.

For GA4 alone, with its own name in the @ menu, use Step 3 instead.

Step 3: Or add the GA4 server as a custom MCP server

A custom MCP server gives ChatGPT the GA4 server on its own. You paste one URL, and the sign-in runs through InsightfulPipe.

1. Copy the server URL, https://google-analytics.insightfulmcp.com/. It sits on the Google Analytics 4 page under MCP Servers in the app.
2. In ChatGPT, go to Plugins, click Add, then Add custom MCP server.
3. Enter the name Google Analytics 4.
4. Under Connection, keep Server URL and paste the URL.
5. Leave Authentication on OAuth.
6. Tick I understand and want to continue, then click Create as a plugin.
7. When the sign-in opens, sign in to InsightfulPipe if asked, and click Authorize access.

If the new plugin is not installed yet, open it under Personal on the Plugins page and install it, as OpenAI's guide describes. No Add custom MCP server option? Use ChatGPT on the web, ask your workspace admin, or install the directory listing in Step 2.

Each time you connect, InsightfulPipe shows a Grant access page. It names the app asking and where its access goes, and lists Your accounts and Requested permissions. Click Authorize access, and ChatGPT reaches only the GA4 properties your workspace connected and granted to you.

Step 4: Use GA4 in a ChatGPT chat

ChatGPT calls an installed plugin when a request needs it, and the @ menu picks it outright. Picking it keeps ChatGPT on your GA4 data instead of web search.

1. Start a new chat.
2. Type @ in the prompt box.
3. Pick Google Analytics 4, or InsightfulPipe if you installed the listing.
4. Name the GA4 property in your request, by name or property ID.

Be explicit, as OpenAI advises. For example: "Use the Google Analytics 4 plugin's query_data tool for this, and do not use web search." That keeps the answer on your live property.

Step 5: Choose which GA4 actions ChatGPT may run

Step 5 decides, property by property, which of the 62 GA4 actions ChatGPT can use. A new Read & write connection starts with 50 of 62 on: every read and write action, with the 12 destructive ones off.

1. In InsightfulPipe, open Connected accounts and find the GA4 property.
2. Click its actions button, such as 50/62 actions. Its tooltip reads Configure actions for this account.
3. Use the All, Read only, Write and Destructive tabs to switch actions on or off.
4. Click Save actions.

Only an owner, admin or operator can change these switches, at any time. The server refuses a switched-off action in every AI client.

ChatGPT has its own layer. Open Settings > Plugin settings, pick the plugin and open Permissions. The choices are Always ask, Allow read-only tools, Allow low-risk tools (the default) and Allow all tools. Choose Allow read-only tools: GA4 reports run without a prompt, and ChatGPT asks before every change.

Verify it worked

Three checks, shortest first, confirm the connection without changing anything in GA4.

1. The plugin is installed. In a new chat, type @ and find the plugin in the list.

2. A prompt that cannot do harm. Its last line tells ChatGPT to leave everything alone.

Use the Google Analytics 4 plugin.
List the GA4 properties available to this connection.
Return the property name, property ID, time zone and currency.
Do not run a report and do not change anything.

3. A real read. Ask for last week's sessions by session default channel group. Compare one number with the Traffic acquisition report in GA4 for the same dates. If check 1 or 2 fails, see Troubleshooting below.

Prompts to run first

Start with reads on a property you know, then try one write on a test property. Name the property in each request.

Two prompts to paste as they are:

Use the Google Analytics 4 plugin and property [PROPERTY_ID].

Compare the last 28 complete days with the previous 28 complete days.
Break the report down by session default channel group.
Include sessions, engaged sessions, engagement rate, key events and total revenue.

Use the Google Analytics 4 plugin and property [PROPERTY_ID].

For the last 14 days, list landing pages with more than [NUMBER] sessions.
Show sessions, engagement rate, key events and average engagement time.
Do not change any setting on the property.

The prompt library and the Claude skills library are free to use, and the prompts work in ChatGPT. In Claude, Claude skills package a whole job, such as the GA4 weekly report or the landing page analyst.

What ChatGPT may change in GA4, and who decides

ChatGPT can use only the GA4 actions an admin has switched on for that property. That makes InsightfulPipe the safest way to let an AI agent change GA4: each limit below is a switch, and your admin decides where it sits.

• 62 actions: 26 read, 24 write, 12 destructive. Writes cover key events, custom dimensions and metrics, audiences, channel groups, data streams, Google Ads and BigQuery links, and property settings.
• GA4 has no paused state. Every write lands at once. No GA4 action spends money; a write changes how you measure.
• Destructive actions stay off until an admin switches them on. The 12 include delete_property, delete_data_stream, delete_key_event, archive_audience and update_data_retention_settings. Shortening retention deletes history, so it sits in this group.
• A read-only connection locks every write until an admin reconnects it with Read & write. It holds only Google's analytics.readonly scope.
• Each property is its own boundary. Edits and deletes stay pinned to the property you connected. create_property can add a property under any account your Google login can edit, so switch it off where nobody should add one.
• Roles hold. Writes need an operator, admin or owner. Members on the User role run only the switched-on reads.

A two-minute video shows ChatGPT creating a custom dimension, a custom metric and a key event from one prompt, then checking them in GA4 Admin. Start a trial, connect GA4 and switch on only the actions ChatGPT needs.

Troubleshooting

Most failures come from a property nobody granted or an action switched off for that property. The MCP troubleshooting guide lists more messages and fixes.

• "No active plan" on the Grant access page. It reads "Your workspace has no active plan or trial. Start or renew a plan in billing, then authorize this app again." Authorize access stays greyed out until then.
• The Grant access page says no accounts are connected yet. It adds: "You can still authorize now. Connect accounts in InsightfulPipe whenever you're ready, and tools that need an account will ask for one." Finish Step 1, then ask again.
• "We could not list any Google Analytics 4 properties for that Google account." Sign in with the Google account that has GA4 access, and check that the property is GA4, not Universal Analytics.
• "This action is disabled for this connected account. An owner or admin must enable it for the account." An owner, admin or operator switches it on under Configure actions for this account.
• "This account is connected read-only, so this action cannot be enabled for it. An owner or admin must reconnect it with Read & Write permissions." Reconnect the property with Read & write, or keep the work to reads.
• "Your role does not have permission to execute write actions. Only operators, admins, and owners can execute write operations." Your workspace role is User. An owner or admin can change it.
• The numbers differ from GA4. Google says "Data processing can take 24-48 hours", and data thresholds can drop small rows. Leave today out, and ask ChatGPT to state the dimensions, metrics and dates it used.

Other hosted GA4 connectors in ChatGPT

AI answers to this question name several hosted GA4 connectors besides InsightfulPipe. Each claim below comes from the vendor's own page, checked on 2026-11-01. InsightfulPipe puts a switch on each of its 62 GA4 actions, per property, with destructive actions off until an admin switches them on.

• Windsor.ai: a ChatGPT plugin. Its GA4 guide says "GA4 through Windsor is read-only, the same as Google's server."
• Composio: a general toolkit with "67 Tools" for Google Analytics, added through the Composio plugin, per its ChatGPT page.
• Markifact: in the ChatGPT plugins marketplace. Its GA4 page lists key events, custom dimensions and metrics, audiences, event rules, data streams, Google Ads links and property settings as "approval-gated" changes. Its GA4 tutorial says: "Markifact's GA4 operations are read-only."
• Ryze AI: "9 GA4 tools, all read-only", per its GA4 page.
• Pipeboard: "Read-only by default", with an edit scope for creating or updating custom dimensions and custom metrics, or creating and deleting conversion events, per its GA4 guide. Its ChatGPT steps still describe Developer mode.
• Two Minute Reports and GrowthSpree: hosted servers that name ChatGPT on their own pages, each through an account with the vendor.

On Google's first page for "google analytics mcp server chatgpt", Coupler.io, Adzviser, CData and Lunar.dev also publish GA4 pages.

The best GA4 MCP servers compares them in depth, and InsightfulPipe vs Windsor.ai goes head to head.

Claude, Claude Code, Codex and Cursor

The same server URL works in every client that supports remote MCP servers, and the same property switches apply in each. Each client finishes with the same InsightfulPipe sign-in and Authorize access step.

• Claude. How to connect Google Analytics 4 to Claude walks it step by step.
• Claude Code. One command, then /mcp to sign in. See Claude Code for marketing data.
• Codex. The ChatGPT Plugins listing works in Codex too, or see the Codex CLI setup guide.
• Cursor. Use the install link on the GA4 MCP page.

claude mcp add --transport http google-analytics-mcp https://google-analytics.insightfulmcp.com/
codex mcp add google-analytics-mcp --url https://google-analytics.insightfulmcp.com/