English Français العربية

Google Analytics 4

Official registry Marketing and sales

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package google-analytics-4-mcp
Claude Code 
claude mcp add google-analytics-4 -e 'GA_CREDENTIALS=<GA_CREDENTIALS>' -e 'GA_CREDENTIALS_PATH=~/.google-analytics-mcp/credentials.json' -- uvx google-analytics-4-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "google-analytics-4": {
            "command": "uvx",
            "args": [
                "google-analytics-4-mcp==0.1.1"
            ],
            "env": {
                "GA_CREDENTIALS": "<GA_CREDENTIALS>",
                "GA_CREDENTIALS_PATH": "~/.google-analytics-mcp/credentials.json"
            }
        }
    }
}

Environment variables

  • GA_CREDENTIALS Google Service Account JSON key content (copy-paste the entire JSON)
  • GA_CREDENTIALS_PATH Alternative: path to the Service Account JSON key file

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Google Analytics 4 MCP Server
  2. Setup (one-time, ~3 minutes)
  3. Installation
  4. Getting Started
  5. Tools (23)
  6. Environment Variables
  7. Example Usage
  8. License

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
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

Frequently asked questions

What is Google Analytics 4?

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

How do I install Google Analytics 4?

It runs on your machine. In Claude Code: claude mcp add google-analytics-4 -e 'GA_CREDENTIALS=<GA_CREDENTIALS>' -e 'GA_CREDENTIALS_PATH=~/.google-analytics-mcp/credentials.json' -- uvx google-analytics-4-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Google Analytics 4 need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Google Analytics 4 open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Google Analytics 4?

It is published by stucchi. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.