{
  "name": "io.github.googleanalytics/google-analytics-mcp",
  "description": "The official Google Analytics MCP connects an AI agent to your GA4 properties through the Analytics Data and Admin APIs. It exposes account and property metadata, ad-hoc reports, funnel reports, realtime reports, and your custom dimensions and metrics. Authentication is Google Application Default Credentials scoped to analytics.readonly, so the agent can read reporting data but cannot change configuration.",
  "status": "active",
  "version": "latest",
  "_meta": {
    "com.top-mcps/lastVerified": "2026-06-15",
    "com.top-mcps/score": {
      "value": 86,
      "rubricVersion": "2026-04",
      "lastComputed": "2026-06-17T11:53:23.803Z",
      "methodology": "https://top-mcps.com/about/methodology"
    },
    "com.top-mcps/stats": {
      "fetchedAt": "2026-06-17T07:09:46.834Z",
      "githubStars": 2392,
      "lastCommitAt": "2026-06-11T13:55:15Z"
    }
  },
  "repository": {
    "url": "https://github.com/googleanalytics/google-analytics-mcp",
    "source": "github"
  },
  "author": {
    "name": "Google Analytics"
  },
  "packages": [
    {
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "identifier": "run",
      "version": "latest",
      "transport": {
        "type": "stdio"
      },
      "runtimeArguments": [
        {
          "type": "positional",
          "value": "analytics-mcp"
        }
      ],
      "environmentVariables": [
        {
          "name": "GOOGLE_APPLICATION_CREDENTIALS",
          "description": "GOOGLE_APPLICATION_CREDENTIALS — required credential for Google Analytics.",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ],
  "capabilities": {
    "tools": [
      {
        "name": "get_account_summaries",
        "description": "List the GA4 accounts and properties the credential can access.",
        "sideEffect": "read"
      },
      {
        "name": "get_property_details",
        "description": "Return metadata for a GA4 property.",
        "sideEffect": "read",
        "args": [
          {
            "name": "property",
            "type": "string",
            "required": true
          }
        ]
      },
      {
        "name": "run_report",
        "description": "Run an ad-hoc GA4 report with dimensions and metrics.",
        "sideEffect": "read"
      },
      {
        "name": "run_funnel_report",
        "description": "Run a funnel report across ordered steps.",
        "sideEffect": "read"
      },
      {
        "name": "run_realtime_report",
        "description": "Return realtime active-user metrics.",
        "sideEffect": "read"
      },
      {
        "name": "get_custom_dimensions_and_metrics",
        "description": "Enumerate custom dimensions and metrics defined on a property.",
        "sideEffect": "read",
        "args": [
          {
            "name": "property",
            "type": "string",
            "required": true
          }
        ]
      }
    ],
    "security": {
      "scope": "read-only",
      "sandbox": "Authenticates via Google ADC with the analytics.readonly scope. Every exposed tool is a report read against the GA4 Data or Admin API — no tool can mutate the property. Grant the service account read access only on the specific GA4 properties the agent should see.",
      "gotchas": [
        "Service-account keys in env persist in client config files. Prefer gcloud ADC + short-lived login over a long-lived key file.",
        "Grant the credential on only the GA4 properties the agent needs — a single key with org-wide access over-exposes data.",
        "Realtime and large date-range reports consume Data API tokens; very high-frequency agent loops can hit the quota."
      ]
    }
  },
  "_links": {
    "html": "https://top-mcps.com/mcp/google-analytics",
    "markdown": "https://top-mcps.com/mcp/google-analytics.md",
    "methodology": "https://top-mcps.com/about/methodology"
  }
}