> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Google Analytics

**Authentication:** OAuth. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* Run a report on sessions and conversions by landing page for the last 28 days.
* List all custom dimensions in the `Production` GA4 property and flag unused ones.
* Compare weekly traffic from paid and organic channels and summarize the trend.

## Available Tools

#### list_accounts

List all Google Analytics accounts you have access to

#### get_account

Get details of a specific Google Analytics account by ID

#### update_account

Update a Google Analytics account's display name

#### list_audiences

List audiences for a property

#### get_audience

Get details of a specific audience

#### create_audience

Create a new audience for a property

#### update_audience

Update an audience's display name or description

#### list_custom_dimensions

List custom dimensions for a property

#### get_custom_dimension

Get details of a specific custom dimension

#### create_custom_dimension

Create a new custom dimension for a property

#### update_custom_dimension

Update a custom dimension's display name or description

#### list_custom_metrics

List custom metrics for a property

#### get_custom_metric

Get details of a specific custom metric

#### create_custom_metric

Create a new custom metric for a property

#### update_custom_metric

Update a custom metric's display name or description

#### list_data_streams

List data streams (websites or mobile apps) for a property

#### get_data_stream

Get details of a specific data stream

#### create_data_stream

Create a new data stream (website or mobile app) for a property

#### list_key_events

List key events (conversions) for a property

#### get_key_event

Get details of a specific key event

#### create_key_event

Create a new key event (conversion) for a property

#### delete_key_event

Delete a key event (conversion) from a property

#### list_properties

List Google Analytics properties under an account

#### get_property

Get details of a specific Google Analytics property

#### create_property

Create a new Google Analytics property in an account

#### update_property

Update a Google Analytics property's settings (display name, timezone, currency code)

#### run_report

Generate a custom Google Analytics report with dimensions, metrics, and filters

#### batch_run_reports

Run multiple reports in a single API call

#### run_realtime_report

Get real-time event data (30-60 minute window) for a property

#### get_metadata

Get all available dimensions and metrics for a property

#### check_compatibility

Validate that dimensions and metrics are compatible for reporting