Google Analytics 4

io.github.stucchi由 GitHub 账号 stucchi 发布v0.1.1更新于 Oct 24, 2026

Manage GA4 properties, data streams, conversions, and run reports via Admin & Data APIs.

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

面向 Google Analytics 4 的 MCP 服务器，让助手通过 Admin 与 Data API 管理 GA4 资源、数据流和转化，并运行报表。

可以做什么
  • 检查已配置服务账号的认证状态
  • 列出账号与资源，创建、查看及软删除资源
  • 列出、创建和删除网站数据流，并生成 gtag.js 跟踪代码片段
  • 列出、创建和删除关键事件（转化）、自定义维度和自定义指标
  • 列出和创建 Google Ads 关联，获取或创建 Measurement Protocol 密钥
  • 按维度、指标、日期和筛选条件运行报表与实时报表，并列出可用维度和指标
适用场景
适合让助手为网站配置 GA4 跟踪、调整转化或自定义维度，或在不打开 GA4 界面的情况下获取会话、国家/地区和实时指标。
运行要求
以 PyPI 包 google-analytics-4-mcp 在本地运行，通常通过 uvx 启动，需要 Python 工具链。需要 Google Cloud 服务账号 JSON 密钥，通过 GA_CREDENTIALS 或 GA_CREDENTIALS_PATH 提供；需在项目中启用 Analytics Admin 与 Data API，并在 GA4 资源访问管理中把服务账号邮箱添加为编辑者。
安装前请注意
服务账号 JSON 密钥是长期凭据，写入 GA_CREDENTIALS 会存进 MCP 配置文件。README 要求编辑者权限，可创建和删除资源、数据流、转化及 Ads 关联，助手的操作会改动线上分析配置；软删除资源或移除数据流会影响数据收集。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Google Analytics 4，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Google Analytics 4 MCP Server

MCP server for Google Analytics 4 — create properties, configure data streams, manage conversions, and run reports via the Admin & Data APIs.

Setup (one-time, ~3 minutes)

  1. Google Cloud Console → IAM & Admin → Service Accounts

    • Create a service account (any name)
    • Click it → Keys → Add Key → JSON → Download

  2. Enable APIs in your GCP project:

  3. GA4 Admin → Property Access Management → Add the service account email (from the JSON) as Editor

  4. Configure credentials (pick one):

    • Option A (recommended): Copy the JSON content into the GA_CREDENTIALS env var in your MCP config
    • Option B: Save the file to ~/.google-analytics-4-mcp/credentials.json

Done. No browser flow, no consent screen, no tokens to refresh.

Installation

Claude Code

bash
claude mcp add google-analytics -e GA_CREDENTIALS='{"type":"service_account",...}' -- uvx google-analytics-4-mcp

Claude Desktop

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "google-analytics": {      "command": "uvx",      "args": ["google-analytics-4-mcp"],      "env": {        "GA_CREDENTIALS": "{\"type\":\"service_account\",\"project_id\":\"...\", ...}"      }    }  }}

From source

bash
git clone https://github.com/stucchi/mcp-google-analytics.gitcd mcp-google-analyticsuv run google-analytics-4-mcp

Getting Started

  1. Check auth: Call check_auth_status to verify the service account is configured
  2. List accounts: Call list_accounts to see your GA4 accounts
  3. Setup a property: Use create_property → create_web_data_stream → get_tracking_snippet
  4. Query data: Use run_report with dimensions and metrics

Tools (23)

Auth

ToolDescription
check_auth_statusVerify service account is configured and valid

Admin API

ToolDescription
list_accountsList accessible GA4 accounts
list_propertiesList properties for an account
create_propertyCreate a GA4 property
get_propertyGet property details
delete_propertySoft-delete a property
list_data_streamsList data streams
create_web_data_streamCreate web stream → get Measurement ID
delete_data_streamDelete a data stream
get_tracking_snippetGenerate gtag.js HTML snippet
list_key_eventsList conversion events
create_key_eventMark event as conversion
delete_key_eventRemove conversion
list_custom_dimensionsList custom dimensions
create_custom_dimensionCreate custom dimension
list_custom_metricsList custom metrics
create_custom_metricCreate custom metric
list_google_ads_linksList Google Ads links
create_google_ads_linkLink Google Ads account
get_measurement_protocol_secretGet/create Measurement Protocol secret

Data API

ToolDescription
run_reportRun report with dimensions, metrics, dates, filters
run_realtime_reportReal-time active users and events
get_metadataList available dimensions and metrics

Environment Variables

VariableDefaultDescription
GA_CREDENTIALS—Service Account JSON key content (copy-paste the entire JSON)
GA_CREDENTIALS_PATH~/.google-analytics-4-mcp/credentials.jsonAlternative: path to the JSON key file

GA_CREDENTIALS takes priority over GA_CREDENTIALS_PATH.

Example Usage

You: "Set up Google Analytics for my website https://mcpadvisor.stucchi.consulting"
Assistant calls: list_accounts → create_property → create_web_data_stream → get_tracking_snippet
Result: Property created with Measurement ID G-XXXXXXXXXX and ready-to-paste HTML snippet.
You: "Show me the top 10 countries by sessions in the last 7 days"
Assistant calls: run_report(property_id="...", dimensions=["country"], metrics=["sessions"], start_date="7daysAgo", limit=10)

License

MIT

来源：README.md，提交 bb4b629

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。