Summary
The Google Analytics MCP server connects Google Analytics 4 data to AI agents and workflows, providing analysis-ready access to website traffic, user behavior, and performance metrics through tools like live schema discovery, server-side aggregation, and safe defaults that minimize data processing overhead. It enables agents to query GA4 properties directly via the Google Analytics Data API using a service account, reducing the need for manual data wrangling and making analytics insights accessible across Claude, ChatGPT, Cursor, and other MCP-compatible platforms. The server solves the problem of agents spending excessive time preparing raw analytics data for analysis by pre-aggregating results server-side and estimating large datasets to prevent workflow disruptions.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Tools
Public tool metadata for what this MCP can expose to an agent.
25 tools
GOOGLE_ANALYTICS_BATCH_RUN_REPORTSTool to return multiple analytics data reports in a batch. Use when you need to fetch multiple reports for one GA4 property in a single request.2 params
Tool to return multiple analytics data reports in a batch. Use when you need to fetch multiple reports for one GA4 property in a single request.
Parameters* required
propertystringRequired. The property resource name. Format: properties/{property_id}
requestsarrayRequired. Up to 5 individual RunReportRequest objects.
GOOGLE_ANALYTICS_CHECK_COMPATIBILITYTool to list dimensions and metrics compatible with a GA4 report request. Use when you need to validate compatibility of chosen dimensions or metrics before running a report.6 params
Tool to list dimensions and metrics compatible with a GA4 report request. Use when you need to validate compatibility of chosen dimensions or metrics before running a report.
Parameters* required
compatibilityFilterstringCompatibility status for dimensions or metrics.one of
COMPATIBILITY_UNSPECIFIED · COMPATIBLE · INCOMPATIBLEdimensionFilterobjectOptional. A FilterExpression for dimensions; must follow GA4 FilterExpression JSON schema.
dimensionsarrayOptional. List of dimensions to check compatibility for.
metricFilterobjectOptional. A FilterExpression for metrics; must follow GA4 FilterExpression JSON schema.
metricsarrayOptional. List of metrics to check compatibility for.
propertystringRequired. GA4 property resource name. Format: properties/{property_id}.
GOOGLE_ANALYTICS_CREATE_AUDIENCE_EXPORTTool to create an audience export. Use after configuring the audience and dimensions to produce a long-running Operation.3 params
Tool to create an audience export. Use after configuring the audience and dimensions to produce a long-running Operation.
Parameters* required
audiencestringAudience resource name to export. Format: properties/{property_id}/audiences/{audience_id}.
dimensionsarrayList of dimensions to include in the export.
parentstringParent resource name. Format: properties/{property_id}.
GOOGLE_ANALYTICS_CREATE_AUDIENCE_LISTTool to create an audience list. Use when you need to define and asynchronously populate a new AudienceList resource under a GA4 property.4 params
Tool to create an audience list. Use when you need to define and asynchronously populate a new AudienceList resource under a GA4 property.
Parameters* required
audiencestringAudience resource name. Format: properties/{property_id}/audiences/{audience_id}.
dimensionsarrayList of dimensions to include in the audience list output.
parentstringParent property resource name. Format: properties/{property_id}.
webhookNotificationobjectConfiguration for receiving webhook notifications about operation status.
GOOGLE_ANALYTICS_CREATE_EXPANDED_DATA_SETTool to create an expanded data set for a property. Use when you need to combine specific dimensions and metrics into a custom dataset after property creation.2 params
Tool to create an expanded data set for a property. Use when you need to combine specific dimensions and metrics into a custom dataset after property creation.
Parameters* required
expandedDataSetobjectDefinition of the ExpandedDataSet to create.
parentstringParent property resource name. Format: properties/{propertyId}
GOOGLE_ANALYTICS_CREATE_ROLLUP_PROPERTYTool to create a GA4 Roll-up Property and optionally initial source links.4 params
Tool to create a GA4 Roll-up Property and optionally initial source links.
Parameters* required
accountstringRequired. Parent account resource. Format: accounts/{account_id}
displayNamestringRequired. Display name for the roll-up property.
sourcePropertiesarrayOptional. List of source property resource names to link. Format: properties/{property_id}.
timeZonestringRequired. IANA time zone for the roll-up property.
GOOGLE_ANALYTICS_GET_ACCOUNTTool to retrieve a single Account by its resource name. Use when you need detailed account info after confirming the account resource name (e.g., accounts/100).1 params
Tool to retrieve a single Account by its resource name. Use when you need detailed account info after confirming the account resource name (e.g., accounts/100).
Parameters* required
namestringRequired. The resource name of the Account to retrieve. Format: accounts/{account_id}, e.g., 'accounts/100'.
GOOGLE_ANALYTICS_GET_AUDIENCE_EXPORTTool to get configuration metadata for an Audience Export. Use after creating an Audience Export to retrieve its status and details.1 params
Tool to get configuration metadata for an Audience Export. Use after creating an Audience Export to retrieve its status and details.
Parameters* required
namestringRequired. The resource name of the Audience Export to retrieve. Format: properties/{property}/audienceExports/{audienceExport}.
GOOGLE_ANALYTICS_GET_AUDIENCE_LISTTool to get configuration metadata about a specific audience list. Use after confirming the audience list resource name.1 params
Tool to get configuration metadata about a specific audience list. Use after confirming the audience list resource name.
Parameters* required
namestringRequired. The resource name of the Audience List to retrieve. Format: properties/{property}/audienceLists/{audienceList}.
GOOGLE_ANALYTICS_GET_KEY_EVENTTool to retrieve a Key Event. Use after confirming the key event resource name.1 params
Tool to retrieve a Key Event. Use after confirming the key event resource name.
Parameters* required
namestringRequired. Resource name of the Key Event to retrieve. Format: properties/{property}/keyEvents/{keyEvent}.
GOOGLE_ANALYTICS_GET_METADATATool to get metadata for dimensions, metrics, and comparisons for a GA4 property. Use when you need to discover available fields before building a report.1 params
Tool to get metadata for dimensions, metrics, and comparisons for a GA4 property. Use when you need to discover available fields before building a report.
Parameters* required
namestringResource name of the metadata to retrieve. Format: properties/{property_id}/metadata. Use property_id=0 to return only universal (non-custom) metadata.
GOOGLE_ANALYTICS_GET_PROPERTY_QUOTAS_SNAPSHOTTool to retrieve all property quotas organized by category for a given property. Use when you need to check current quota usage for a GA4 property.1 params
Tool to retrieve all property quotas organized by category for a given property. Use when you need to check current quota usage for a GA4 property.
Parameters* required
propertystringRequired. The property resource. Format: properties/{property_id}.
GOOGLE_ANALYTICS_LIST_ACCOUNTSTool to list all Accounts accessible by the caller. Use when you need to enumerate all Google Analytics accounts your credentials can access.3 params
Tool to list all Accounts accessible by the caller. Use when you need to enumerate all Google Analytics accounts your credentials can access.
Parameters* required
pageSizeintegerOptional. Maximum number of accounts to return. Must be ≥1.
pageTokenstringOptional. Token for retrieving the next page of results.
showDeletedbooleanOptional. Whether to include soft-deleted (trashed) Accounts.
GOOGLE_ANALYTICS_LIST_AUDIENCE_EXPORTSTool to list all audience exports for a GA4 property. Use when you need to fetch its export history after initiating exports.3 params
Tool to list all audience exports for a GA4 property. Use when you need to fetch its export history after initiating exports.
Parameters* required
pageSizeintegerOptional. Maximum number of results to return. Defaults to 200; larger values are coerced to 1000.
pageTokenstringOptional. Token for retrieving the next page of results; other parameters must match original call when paginating.
parentstringRequired. Resource name of the parent property. Format: properties/{property_id}
GOOGLE_ANALYTICS_LIST_AUDIENCE_LISTSTool to list all audience lists for a GA4 property. Use when you need to retrieve a property's configured audience lists after confirming the property ID.3 params
Tool to list all audience lists for a GA4 property. Use when you need to retrieve a property's configured audience lists after confirming the property ID.
Parameters* required
pageSizeintegerOptional. Maximum number of audience lists to return. Defaults to 200; maximum is 1000.
pageTokenstringOptional. Token for retrieving the next page of results.
parentstringRequired. Resource name of the parent property. Format: properties/{property_id}
GOOGLE_ANALYTICS_LIST_AUDIENCESTool to list all audiences on a property. Use when you need to fetch all audiences for a GA4 property after confirming its existence.3 params
Tool to list all audiences on a property. Use when you need to fetch all audiences for a GA4 property after confirming its existence.
Parameters* required
pageSizeintegerOptional. Maximum number of Audiences to return.
pageTokenstringOptional. Token for retrieving the next page of results.
parentstringRequired. Property ID or full resource name. Accepts: '123456789' or 'properties/123456789'
GOOGLE_ANALYTICS_LIST_KEY_EVENTSTool to list Key Events. Use when you need to retrieve all key event definitions for a given property.3 params
Tool to list Key Events. Use when you need to retrieve all key event definitions for a given property.
Parameters* required
pageSizeintegerOptional. Maximum number of results to return. Must be between 1 and 200.
pageTokenstringOptional. Token for retrieving the next page of results.
parentstringRequired. Resource name of the parent property. Format: properties/{property_id}.
GOOGLE_ANALYTICS_LIST_PROPERTIESTool to list GA4 properties under a specific account. Use after obtaining an account ID; supports pagination and including soft-deleted properties.4 params
Tool to list GA4 properties under a specific account. Use after obtaining an account ID; supports pagination and including soft-deleted properties.
Parameters* required
accountstringRequired. The account resource name. Format: accounts/{account_id}
pageSizeintegerOptional. Maximum number of properties to return; must be between 1 and 200.
pageTokenstringOptional. Token returned from a previous call to retrieve the next page of results.
showDeletedbooleanOptional. Whether to include soft-deleted (trashed) properties.
GOOGLE_ANALYTICS_LIST_REPORTING_DATA_ANNOTATIONSTool to list all Reporting Data Annotations on a property. Use when you need to retrieve or inspect annotations for a GA4 property.4 params
Tool to list all Reporting Data Annotations on a property. Use when you need to retrieve or inspect annotations for a GA4 property.
Parameters* required
filterstringRestricts which annotations are listed. Supported fields: name, title, description, annotationDate, annotationDateRange, color; operations: =, !=, <, >, <=, >=, :, =~, !~, NOT, AND, OR; helper func...
pageSizeintegerOptional. Maximum number of annotations to return. Defaults to 50, max 200.
pageTokenstringOptional. Token for retrieving the next page of results.
parentstringResource name of the property. Format: properties/{property_id}.
GOOGLE_ANALYTICS_LIST_ROLLUP_PROPERTIESTool to list roll-up GA4 properties accessible to the caller. Use when you need to identify roll-up properties across all accessible accounts.1 params
Tool to list roll-up GA4 properties accessible to the caller. Use when you need to identify roll-up properties across all accessible accounts.
Parameters* required
pageSizeintegerOptional. Maximum number of account summaries to return; must be between 1 and 200.
GOOGLE_ANALYTICS_LIST_SEARCH_ADS360_LINKSTool to list all SearchAds360Links on a property. Use when you need to fetch all Search Ads 360 links for a given property after authenticating.3 params
Tool to list all SearchAds360Links on a property. Use when you need to fetch all Search Ads 360 links for a given property after authenticating.
Parameters* required
pageSizeintegerOptional. Maximum number of results to return. Must be between 1 and 200. Defaults to 50.
pageTokenstringOptional. Token for retrieving the next page of results.
parentstringRequired. Resource name of the property. Format: properties/{propertyId} (e.g., properties/1234).
GOOGLE_ANALYTICS_QUERY_AUDIENCE_EXPORTTool to query a completed audience export. Use when you need to fetch user rows with pagination.3 params
Tool to query a completed audience export. Use when you need to fetch user rows with pagination.
Parameters* required
limitintegerOptional. Number of rows to return. Must be between 1 and 250000. Defaults to 10000.
namestringRequired. Resource name of the audience export. Format: properties/{property}/audienceExports/{audienceExport}.
offsetintegerOptional. Zero-based start row index for pagination. Defaults to 0.
GOOGLE_ANALYTICS_QUERY_AUDIENCE_LISTTool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination.3 params
Tool to query an audience list. Use when you need to retrieve user rows from a GA4 audience list with pagination.
Parameters* required
limitintegerOptional. Number of rows to return; default 10,000; maximum 250,000.
namestringRequired. Audience list resource to query. Format: properties/{property}/audienceLists/{audienceList}.
offsetintegerOptional. Zero-based row offset for pagination.
GOOGLE_ANALYTICS_RUN_FUNNEL_REPORTTool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property.10 params
Tool to run a GA4 funnel report. Use when you need a customized funnel analysis report for a given property.
Parameters* required
dateRangesarrayList of date ranges to read; overlapping ranges duplicate days across ranges.
dimensionFilterobjectDimension-only filter expression.
funnelobjectFunnel configuration object following the API schema (must include 'steps').
funnelBreakdownobjectBreakdown dimension configuration for the funnel table sub-report.
funnelNextActionobjectNext-action dimension configuration for the funnel visualization sub-report.
funnelVisualizationTypestringVisualization type: STANDARD_FUNNEL (default) or TRENDED_FUNNEL.one of
STANDARD_FUNNEL · TRENDED_FUNNELlimitintegerNumber of rows to return. Default 10000; max 250000.
propertystringGA4 property resource name, format: properties/{property_id}.
returnPropertyQuotabooleanIf true, includes the property's current quota state.
segmentsarrayUp to 4 segments; each yields its own row in the report.
GOOGLE_ANALYTICS_RUN_REPORTTool to run a customized GA4 data report. Use when you need event data after specifying dimensions, metrics, and date ranges.15 params
Tool to run a customized GA4 data report. Use when you need event data after specifying dimensions, metrics, and date ranges.
Parameters* required
cohortSpecobjectOptional. Cohort specification. Requires requesting the cohort dimension.
comparisonsarrayOptional. The comparison configuration. Adds a comparison column to the response.
currencyCodestringOptional. The currency code to apply, in ISO 4217 format. Defaults to property currency.
dateRangesarrayOptional. The date ranges to read. Each range requires 'startDate' and 'endDate'.
dimensionFilterobjectOptional. The filter expression to restrict dimension values. Only dimensions are allowed.
dimensionsarrayOptional. The dimensions to request and display. Each dimension is an object with a 'name' field.
keepEmptyRowsbooleanOptional. If true, rows with all zero metrics will be returned; otherwise omitted.
limitintegerOptional. Number of rows to return. Must be between 1 and 250000.
metricAggregationsarrayOptional. Aggregation types to include over metrics, e.g., 'TOTAL', 'MINIMUM', 'MAXIMUM'.
metricFilterobjectOptional. The filter expression to restrict metric values. Applied after aggregation.
metricsarrayOptional. The metrics to request and display. Each metric is an object with a 'name' field.
offsetintegerOptional. 0-based start row for pagination. Must be >= 0.
orderBysarrayOptional. Specify how rows are ordered. Each object defines dimension or metric ordering.
propertystringRequired. The property resource on which to run the report. Format: properties/{property_id}.
returnPropertyQuotabooleanOptional. If true, include the property's current quota state in the response.
Google Analytics 4 (GA4) MCP Server 📊
Model Context Protocol (MCP) server for Google Analytics 4: real-time query exploration, schema discovery, metric aggregation, and audience insights for AI agents.
🌐 Live Documentation & Web Portal: https://ga4.builditwithai.xyz
⚡ Quickstart
# 1-Line Universal Installer (Auto-configures Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed, Windsurf)
curl -fsSL "https://ga4.builditwithai.xyz/install" | bash
# Or run directly via your preferred runtime:
uvx google-analytics-mcp
uvx --from google-analytics-mcp ga4-mcp-server
python -m ga4_mcp
npx -y @surendranb/google-analytics-mcp
🤖 Client Setup
A. Claude Code (CLI)
claude mcp add google-analytics -- uvx google-analytics-mcp
B. Cursor & Google Antigravity (mcp.json)
{
"mcpServers": {
"google-analytics": {
"command": "uvx",
"args": ["google-analytics-mcp"]
}
}
}
C. Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"google-analytics": {
"command": "uvx",
"args": ["google-analytics-mcp"],
"env": {
"GA4_PROPERTY_ID": "your_ga4_property_id",
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service_account.json"
}
}
}
}
D. VS Code (Cline / Roo Code / Continue)
{
"mcpServers": {
"google-analytics": {
"command": "npx",
"args": ["-y", "@surendranb/google-analytics-mcp"]
}
}
}
🛠️ Tools & Capabilities
| Tool Name | Parameters | Description | Return Type |
|---|---|---|---|
get_ga4_data | dimensions (list), metrics (list), date_ranges (list), limit (int) | Runs multi-dimensional GA4 reports with automated metric totals and server-side aggregation. | JSON / Markdown |
list_accounts | (none) | Lists all accessible Google Analytics accounts and permission levels. | JSON |
list_properties | account_id (optional) | Lists all GA4 properties associated with an account. | JSON |
get_property_metadata | property_id (optional) | Fetches complete dimension and metric schemas, custom definitions, and compatibility rules. | JSON |
run_realtime_report | metrics (list), dimensions (list) | Queries real-time active users and event counts from the last 30 minutes. | JSON |
search_skills | query (string) | Searches built-in GA4 analytical playbooks (e-commerce, channel attribution, bot filtering). | Markdown |
skill_read | skill_name (string) | Dynamically loads procedural skills and analytical guides from GitHub. | Markdown |
skills_list | (none) | Lists all available live GA4 analytical skills. | JSON |
🧠 Dynamic Skills & Guided Playbooks
This server ships with built-in analytical recipes that load dynamically from GitHub:
traffic-diagnosis: Step-by-step root cause analysis for sudden traffic drops.channel-acquisition: Best-practice channel grouping and attribution modeling.ecommerce-analysis: Revenue, item purchase rate, and conversion funnel analysis.ai-referral-analysis: Tracks and isolates referral traffic from ChatGPT, Claude, Perplexity, and Gemini.
🔒 Telemetry & Privacy
This package collects anonymous, non-PII diagnostic telemetry (command executions, latency, error codes) to improve tool reliability. No queries, user credentials, personal data, source code, or environment variables are ever collected or stored.
You can opt out anytime by setting either of the following environment variables:
export DO_NOT_TRACK=1
# or
export MCP_TELEMETRY_OPT_OUT=1
📄 License
MIT License. See LICENSE for details.
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
YOUR_API_KEY*secretYour API key for the service
Registryactive
Packagegoogle-analytics-mcp
TransportSTDIO
AuthRequired
UpdatedSep 9, 2025
