Google Analytics MCP integration for AI agents.
Connect AI agents to Google Analytics through 28 structured actions, including check compatibility, batch run pivot reports, and archive custom dimension. Re…
- ACTION CONTRACTS
- 28
- AUTHENTICATION
- OAuth 2.0
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Google Analytics integration exposes
The Google Analytics Agent App exposes 28 provider-backed actions for data and marketing work. Its current contract lets an authorized agent check whether selected google analytics dimensions and metrics can be queried together, run up to five google analytics data api pivot reports in one batch request for a single property, and archive a google analytics custom dimension that should no longer be available for reporting configuration. These operations are called through Working Machines as typed capabilities rather than through browser navigation or copied UI steps.
A connection uses OAuth 2.0. Before execution, the agent can inspect the selected action, its required fields, declared scopes, and expected output contract. Provider credentials remain inside the Working Machines runtime; the calling agent receives the capability and its structured result, not the underlying secret.
For reliable operation, start with the narrowest action that satisfies the task, resolve stable provider identifiers before changing state, and validate the returned object or status after execution. Availability still depends on the connected Google Analytics account, granted provider permissions, workspace policy, region, plan, and upstream API behavior.
VERIFIED ACTION SAMPLE
Real Google Analytics capabilities.
Showing 12 of 28 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
check_compatibilityREADCheck whether selected Google Analytics dimensions and metrics can be queried together.
INPUTS: propertyId / dimensions / metrics / dimensionFilter / metricFilter
batch_run_pivot_reportsWRITERun up to five Google Analytics Data API pivot reports in one batch request for a single property.
INPUTS: propertyId / requests
archive_custom_dimensionHIGH IMPACTArchive a Google Analytics custom dimension that should no longer be available for reporting configuration.
INPUTS: customDimensionName
archive_custom_metricHIGH IMPACTArchive a Google Analytics custom metric that should no longer be available for reporting configuration.
INPUTS: customMetricName
batch_run_reportsWRITERun up to five Google Analytics Data API reports in one batch request for a single property.
INPUTS: propertyId / requests
create_custom_dimensionWRITECreate a Google Analytics custom dimension so reporting can use a business-specific event, user, or item attribute.
INPUTS: propertyId / parameterName / displayName / description / scope
create_custom_metricWRITECreate a Google Analytics custom metric so reports can measure business-specific event values.
INPUTS: propertyId / parameterName / displayName / description / measurementUnit
get_metadataREADGet available dimensions and metrics for a Google Analytics property before building reports.
INPUTS: propertyId
get_property_overviewREADGet the key setup details for a Google Analytics property before choosing reports.
INPUTS: propertyId
get_property_quotas_snapshotREADGet the Google Analytics Data API quota snapshot for a property without running a report.
INPUTS: propertyId
list_account_summariesREADList Google Analytics accounts and property summaries visible to the connected Google account.
INPUTS: pageSize / pageToken
list_custom_dimensionsREADList custom dimensions configured on a Google Analytics property.
INPUTS: propertyId / pageSize / pageToken
INPUT CONTRACTS
Know what the action needs before it runs.
check_compatibility
propertyIdREQUIRED- The Google Analytics property ID, with or without the properties/ prefix.
dimensionsOPTIONAL- The dimensions to check for compatibility.
metricsOPTIONAL- The metrics to check for compatibility.
dimensionFilterOPTIONAL- A Google Analytics Data API FilterExpression object.
metricFilterOPTIONAL- A Google Analytics Data API FilterExpression object.
batch_run_pivot_reports
propertyIdREQUIRED- The Google Analytics property ID, with or without the properties/ prefix.
requestsREQUIRED- The RunPivotReportRequest objects to execute in the batch.
archive_custom_dimension
customDimensionNameREQUIRED- The custom dimension resource name, such as properties/123/customDimensions/456.
archive_custom_metric
customMetricNameREQUIRED- The custom metric resource name, such as properties/123/customMetrics/456.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Inspect Check Compatibility
Check whether selected Google Analytics dimensions and metrics can be queried together. Use this as a bounded discovery step, retain the returned identifier, and avoid expanding the read beyond the task's stated scope.
check_compatibilityControl Batch Run Pivot Reports
Run up to five Google Analytics Data API pivot reports in one batch request for a single property. Resolve the target first, present material changes for confirmation, and make retries idempotent where the provider supports it.
batch_run_pivot_reportsVerify with Get Metadata
Get available dimensions and metrics for a Google Analytics property before building reports. Compare the returned provider state with the intended outcome and preserve stable IDs or canonical links in the run record.
get_metadataSAFETY BOUNDARY
Operate Google Analytics with explicit limits
- Authorize Google Analytics with OAuth 2.0 and grant only the provider access required by the selected actions.
- 18 actions are change-capable by name. Confirm the target identity and material parameters before allowing a write.
- Treat `archive_custom_dimension` and `archive_custom_metric` as high-impact operations and require an explicit approval boundary.
- The sampled contract declares provider scopes including `https://www.googleapis.com/auth/analytics.edit` and `https://www.googleapis.com/auth/analytics.readonly`; verify the complete action contract before execution.
- After a call, inspect the structured result and execution record before reporting that the Google Analytics task completed successfully.
CONNECTION MODEL
OAuth 2.0
Google Analytics uses OAuth 2.0. Connection requirements and availability are determined by the provider and the Working Machines deployment.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 10
- WRITE SIGNALS
- 16
- HIGH IMPACT
- 2
- REVIEW SIGNALS
- 0
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Google Analytics.