google-analytics-mcp

google-analytics-mcp

MCP.Pizza Chef: surendranb

Google Analytics 4 becomes something you can simply talk to: visits by country, the pages people land on, where the traffic came from, how a campaign did, and how this month compares with last. It plugs into Claude, ChatGPT, Gemini, Cursor, VS Code, and Windsurf through a one-line installer or a short config block. You need a free Google Cloud service-account key file and viewer access to the property, and it only ever reads your data.

Data
Web/Research

Use This MCP server To

See which pages brought the most visitors last month Compare this month's traffic with the same month last year Find out which countries my readers come from Check how a campaign performed after launch Ask which traffic sources send the best visitors Pull a quick weekly traffic summary for my team

README

Google Analytics MCP Logo

Google Analytics 4 MCP Server

mcp-name: io.github.surendranb/google-analytics-mcp

PyPI Version CI Status GitHub Stars License

Connect Google Analytics 4 data directly to AI agents, analyst copilots, and MCP runtimes across Claude, ChatGPT, Gemini, Cursor, VS Code, and OpenClaw. Gives models analysis-ready GA4 access with live schema discovery, metric auto-aliasing, server-side aggregation, and autonomous self-healing defenses.

🌐 Website & Documentation: https://ga4mcp.com
🔗 Sister Project: Google Search Console MCP

PyPI Downloads Breakdown and Trend
Powered by pypi.builditwithai.xyz


⚡ Quickstart — 1-Line Installations

1. Universal 1-Line Installer (Recommended)

Auto-detects your system, configures Gemini CLI, Claude Desktop, Cursor, and VS Code automatically in 1 command:

curl -fsSL https://ga4.builditwithai.xyz | bash

google-analytics-mcp FAQ

Which apps does it work in?
Claude, ChatGPT, Gemini CLI, Cursor, VS Code, Windsurf, and other MCP clients.
Do I need credentials?
Yes — a free Google Cloud service-account key file, plus viewer access granted to your Analytics property.
Can I use this to build a monthly traffic report?
Yes. Ask for the period and the breakdown you want and it returns the figures to write up.
Can it change anything in my Analytics account?
No. Viewer access is all it asks for, so it reads and nothing more.
How hard is setup?
There is a one-line installer for common apps, or you paste a short config block with your key path and property number.
Does it work with the older Universal Analytics?
No. It reads Google Analytics 4 properties only.