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:

   • Google Analytics Admin API
   • Google Analytics Data API

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

Admin API

Data API

Environment Variables

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