How do I install the ga4 mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GA4_PROPERTY_ID`, `GOOGLE_APPLICATION_CREDENTIALS`, `GA4_CLIENT_ID`, `GA4_CLIENT_SECRET`, `GA4_REFRESH_TOKEN`, `REFRESH_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Ga4 MCP Server

Google Analytics 4 MCP: reports, realtime data, custom dimensions, data streams.

Local serverstdio

What is the Ga4 MCP Server?

Google Analytics 4 MCP: reports, realtime data, custom dimensions, data streams.

What the server does

9 tools covering reporting, realtime data, custom dimensions/metrics, data streams, and feedback
Two configuration modes: single-property (env vars) and multi-client (config.json)
Supports both service account and OAuth credentials
Relative date support (today, yesterday, 7daysAgo, 30daysAgo, 90daysAgo)
Built on official Google SDKs with resilience patterns

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
ga4_get_client_context	Returns the active GA4 property ID and client name
ga4_run_report	Run a standard GA4 report with dimensions, metrics, date range, and filters
ga4_realtime_report	Query realtime data (last 30 minutes)
ga4_list_custom_dimensions	List all custom dimensions for the property
ga4_create_custom_dimension	Create a new custom dimension
ga4_list_custom_metrics	List all custom metrics for the property
ga4_list_data_streams	List web/app data streams and their measurement IDs
ga4_send_feedback	Submit feedback on a query result
ga4_suggest_improvement	Suggest a new query pattern or improvement

How to install the Ga4 MCP Server

claude mcp add ga4 --env GA4_PROPERTY_ID=your-value --env GOOGLE_APPLICATION_CREDENTIALS=your-value --env GA4_CLIENT_ID=your-value --env GA4_CLIENT_SECRET=your-value --env GA4_REFRESH_TOKEN=your-value --env REFRESH_TOKEN=your-value -- npx -y mcp-ga4

Configuration

Variable	Description	Required
GA4_PROPERTY_ID	Configuration value read at startup.	Optional
GOOGLE_APPLICATION_CREDENTIALS	Configuration value read at startup.	Optional
GA4_CLIENT_ID	Configuration value read at startup.	Optional
GA4_CLIENT_SECRET	Credential the server authenticates with.	Yes
GA4_REFRESH_TOKEN	Credential the server authenticates with.	Yes
REFRESH_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use Ga4 to ga4 get client context.”
“Use Ga4 to ga4 run report.”
“Use Ga4 to ga4 realtime report.”

Frequently asked questions

Google Analytics 4 MCP: reports, realtime data, custom dimensions, data streams. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.