AI Knowledge Hub
Menu

Tools & MCP / Analytics

GA4 MCP Connector

Launchable read-only GA4 Data API MCP server with bounded queries, property isolation, typed authentication, and normalized source metadata.

Access

Read only · Google Analytics 4

Setup requiredAPI or MCP integrationRequirements & limitsRelated reading

Inputs

  • An allowed GA4 property ID
  • Start and end dates
  • Packaged metric names, with optional dimensions and result limits

Outputs

  • Normalized report columns and rows
  • Pagination, provider identity and retrieval freshness
  • Bounded error diagnostics when a request fails

Before you begin

  • Node.js 22 or newer.
  • GA4_CREDENTIAL runtime binding and GA4_ALLOWED_PROPERTY_IDS configuration.
  • Google Analytics Data API enabled with read access to each allowed property.

Try this first

Review the setup requirements, access boundaries and release guide before connected use.

Limits for this step
  • The connector does not expose GA4 administration or mutation endpoints.
  • Reports are limited to the packaged dimension and metric allowlists.
  • Read-only report retrieval only; property, field, date, pagination, timeout, and response-size bounds are enforced before results are returned.
Review setup requirements

Summary sources · Catalogue metadata, tool.yaml, TOOL.md, README.md, examples/input.json, examples/output.json · v0.2.0 · Release package

View capabilities and accessHide capabilities and accessv0.2.0

What it can do

  • Run bounded read-only reports for explicitly allowed GA4 properties.
  • Return normalized dimensions, metrics, pagination, and source freshness.
  • Live-verify bearer or service-account identity and property access.

Access limits

Read-only report retrieval only; property, field, date, pagination, timeout, and response-size bounds are enforced before results are returned.

Trust boundary · remote-mcp-server

Credentials and setup

  • GA4 read-only OAuth credential with access to each allowed property

Install tool files

These commands install package files and generate runtime configuration where supported. Confirm discovery in your agent app, then check configuration, authentication and a first useful operation.

Install (Codex)

./bin/skills-hub install --module tools --entry analytics/[email protected] --runtime codex

Install (Claude)

./bin/skills-hub install --module tools --entry analytics/[email protected] --runtime claude

Install (Generic)

./bin/skills-hub install --module tools --entry analytics/[email protected] --runtime generic --target ./my-agent/tools-mcp

How You Can Use This

Setup required

Resource form: API or MCP integration

Configuration, credentials or runtime bindings are required. Check the prerequisites and limits for your intended environment.

First run: Configure GA4_CREDENTIAL, set GA4_ALLOWED_PROPERTY_IDS, then register .mcp.json with Codex, Claude, or a generic MCP client.

Setup required

  • Node.js 22 or newer.
  • GA4_CREDENTIAL runtime binding and GA4_ALLOWED_PROPERTY_IDS configuration.
  • Google Analytics Data API enabled with read access to each allowed property.

Current limits

  • The connector does not expose GA4 administration or mutation endpoints.
  • Reports are limited to the packaged dimension and metric allowlists.
What installation and verification mean
File installation
Places package files and generated configuration in the selected directories.
Native discovery
Your agent app finds and accepts the instructions, tools or plugin registrations.
Mock execution
Exercises sample fixtures. Connected data and provider effects need a separate check.
Connected operation
Requires current configuration, provider authentication, scoped permissions and a successful operation in your intended environment.

Declared compatibility

Maintainer-reviewed information for version 0.2.0 · Reviewed 2026-10-31. This is not a live provider check.

  • Google Analytics Data API: v1beta
  • Runtime: Node.js 22 or newer
  • Uses Node's built-in HTTP functionality; no Google SDK is packaged.

Limits

  • Requires a configured GA4 property and read-only credentials.

Packaged connector manifest

Classification: declared

Technical details and release files

Review and lifecycle

Review maturity: Experimental

Security review declaration: Not declared

Lifecycle: Active

These release declarations are separate from evidence that a workflow operates in your environment.

Runtime & Dependencies

ID: analytics/ga4-mcp-connector

Tags: ga4, mcp, analytics, read-only

Runtimes: codex, claude, generic

Dependencies & Setup

MCP servers: Not documented

APIs: Google Analytics Data API v1beta

Local tools: Not documented