1. Conduid
  2. Developer Tools
  3. Google Analytics 4
MCP server · Developer Tools

Google Analytics 4

· github.com/stucchi/mcp-google-analytics

Google Analytics 4: 27 read-only tools across the Data API and the Admin API.

Unclaimed science
InstallView source
37Low

Scored 2 days ago · breakdown

About Google Analytics 4

Google Analytics 4 is an MCP server in the Developer Tools category: google Analytics 4: 27 read-only tools across the Data API and the Admin API.

Install

Claude Code
claude mcp add google-analytics-4 -- npx -y @getmcpads/google-analytics-mcp-server
npx
npx -y @getmcpads/google-analytics-mcp-server
uvx
uvx google-analytics-4-mcp
pip
pip install google-analytics-4-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (1)

check_auth_statusVerify service account is configured and valid

Parameters not published.

Ask AI

✦

Ask AI about Google Analytics 4

Powered by Claude · Grounded in docs

I know everything about Google Analytics 4. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

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

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

Claude Desktop

Add to claude_desktop_config.json:

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

From source

git clone https://github.com/stucchi/mcp-google-analytics.git
cd mcp-google-analytics
uv 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

Tool Description
check_auth_status Verify service account is configured and valid

Admin API

Tool Description
list_accounts List accessible GA4 accounts
list_properties List properties for an account
create_property Create a GA4 property
get_property Get property details
delete_property Soft-delete a property
list_data_streams List data streams
create_web_data_stream Create web stream → get Measurement ID
delete_data_stream Delete a data stream
get_tracking_snippet Generate gtag.js HTML snippet
list_key_events List conversion events
create_key_event Mark event as conversion
delete_key_event Remove conversion
list_custom_dimensions List custom dimensions
create_custom_dimension Create custom dimension
list_custom_metrics List custom metrics
create_custom_metric Create custom metric
list_google_ads_links List Google Ads links
create_google_ads_link Link Google Ads account
get_measurement_protocol_secret Get/create Measurement Protocol secret

Data API

Tool Description
run_report Run report with dimensions, metrics, dates, filters
run_realtime_report Real-time active users and events
get_metadata List available dimensions and metrics

Environment Variables

Variable Default Description
GA_CREDENTIALS — Service Account JSON key content (copy-paste the entire JSON)
GA_CREDENTIALS_PATH ~/.google-analytics-4-mcp/credentials.json Alternative: 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 copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Google Analytics 4

How do I install Google Analytics 4?

Run claude mcp add google-analytics-4 -- npx -y @getmcpads/google-analytics-mcp-server, then add the server to your MCP client's configuration.

Is Google Analytics 4 safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Google Analytics 4 still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.