How to Use the Google Analytics MCP in Windsurf

Q: How do I connect Google Analytics to Windsurf?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file. Cascade automatically discovers the 12 tools, letting you query live GA4 properties immediately.

Q: Can Windsurf run batch Google Analytics reports automatically?

Yes, Cascade can execute batchrunreports to pull multiple metrics in a single network call. This keeps your API token usage low while loading complex datasets.

Q: How does this Google Analytics MCP Server prevent API errors in Windsurf?

The server exposes checkcompatibility to verify dimension and metric combinations before running queries. Cascade uses this to prevent broken API requests during code generation.

Q: Can I export specific user lists?

Yes, you can use listaudienceexports and getaudienceexport to pull user segments. Your agent can fetch these lists directly into your workspace for target analysis.

Get live GA4 reporting directly inside Windsurf as Cascade chains multi-step reports and builds your dashboards.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Analytics MCP to Windsurf

Create your Vinkius account to connect Google Analytics to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Google Analytics with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade chains automated GA4 audits

Your agent uses `list_accounts` and `list_properties` to audit your tracking setup in seconds. By chaining these tools, Cascade maps out every property without forcing you into the slow web interface. Next, the agent runs `check_compatibility` to make sure your custom dimensions do not break the reporting API. It verifies everything before writing a single line of backend code.

Build complex dashboards with this MCP Server

This MCP Server exposes `run_report` and `batch_run_reports` so your agent can pull raw metrics directly into your local UI components. Cascade writes the frontend code, grabs the live GA4 data, and tests the rendering in one sequence. You get working dashboard widgets without manual data exports. It is the fastest way to build analytics tools.

Real-time user journey mapping

Using `run_realtime_report` and `get_user_activity`, Windsurf monitors active campaigns as they happen. The agent instantly pulls active user counts and traces specific drop-off paths. It also runs `run_funnel_report` to pinpoint where checkout flows fail. You see the exact step where users leave, backed by live production data.

Setup guide

Set up Google Analytics MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Google Analytics MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Google Analytics payment history." If connected, Cascade will call the Google Analytics tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "google-analytics-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Google Analytics 4. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Google Analytics now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Google Analytics MCP in Windsurf

Add the server configuration to your `~/.codeium/windsurf/mcp_config.json` file. Cascade automatically discovers the 12 tools, letting you query live GA4 properties immediately.

Yes, Cascade can execute `batch_run_reports` to pull multiple metrics in a single network call. This keeps your API token usage low while loading complex datasets.

The server exposes `check_compatibility` to verify dimension and metric combinations before running queries. Cascade uses this to prevent broken API requests during code generation.

Yes, you can use `list_audience_exports` and `get_audience_export` to pull user segments. Your agent can fetch these lists directly into your workspace for target analysis.

Your GA4 property IDs, audience lists, and raw event metrics stay strictly inside the secure V8 sandbox. This MCP Server acts as an ephemeral bridge, passing data directly to your local Windsurf environment without external storage.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript