> This page is for Agent Handler.

> 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