`google_ads_get_activities`

Get Google Ads Activities

Google

Description

Retrieve change history for a Google Ads account. Always fetches fresh data. Only changes within the past 30 days are available (API limit), and changes may take up to 3 minutes to appear. For CAMPAIGN_CRITERION events, use the description field as the definitive interpretation when present.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_activities",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "Review recent account changes"
    }
  }
}

hopkin google activities get

Flag	Type	Required	Description
`--customer-id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)
`--login-customer-id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accounts
`--start-date`	`string`	Optional	Start date in YYYY-MM-DD format. Defaults to 7 days ago. Must be within the past 30 days.
`--end-date`	`string`	Optional	End date in YYYY-MM-DD format. Defaults to today.
`--resource-type`	`string`	Optional	Filter to a specific resource type: AD, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION, CAMPAIGN, CAMPAIGN_BUDGET, CAMPAIGN_CRITERION, ASSET, ASSET_SET
`--asset-ids`	`array`	Optional	Filter to specific asset IDs (numeric). Automatically sets resource_type to ASSET.
`--limit`	`integer`	Optional	Maximum number of activities to return (1-1000, default 50)
`--cursor`	`string`	Optional	Opaque pagination cursor from a previous response

{
  "mcpServers": {
    "google-ads": {
      "url": "https://mcp.hopkin.ai/google-ads/mcp",
      "transport": "sse"
    }
  }
}

Recent account activity
Campaign changes only
Custom date range
With MCC login
Specific asset activity

Parameters

Name	Type	Required	Description
`customer_id`	`string`	Required	The Google Ads Customer ID (10 digits, with or without dashes)pattern: ^[\d-]+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (7)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`start_date`	`string`	Optional	Start date in YYYY-MM-DD format. Defaults to 7 days ago. Must be within the past 30 days.pattern: ^\d{4}-\d{2}-\d{2}$
`end_date`	`string`	Optional	End date in YYYY-MM-DD format. Defaults to today.pattern: ^\d{4}-\d{2}-\d{2}$
`resource_type`	`string`	Optional	Filter to a specific resource type: AD, AD_GROUP, AD_GROUP_AD, AD_GROUP_CRITERION, CAMPAIGN, CAMPAIGN_BUDGET, CAMPAIGN_CRITERION, ASSET, ASSET_SET `AD` `AD_GROUP` `AD_GROUP_AD` `AD_GROUP_CRITERION` `CAMPAIGN` `CAMPAIGN_BUDGET` `CAMPAIGN_CRITERION` `ASSET` `ASSET_SET`
`asset_ids`	`array`	Optional	Filter to specific asset IDs (numeric). Automatically sets resource_type to ASSET.
`limit`	`integer`	Optional	Maximum number of activities to return (1-1000, default 50)min: 1, max: 1000
`cursor`	`string`	Optional	Opaque pagination cursor from a previous response

Examples

Recent account activity

{
  "customer_id": "1234567890",
  "reason": "Review recent account changes"
}

hopkin google activities get --customer-id 1234567890

Campaign changes only

{
  "customer_id": "1234567890",
  "resource_type": "CAMPAIGN",
  "reason": "See recent campaign edits"
}

hopkin google activities get --customer-id 1234567890 --resource-type CAMPAIGN

Custom date range

{
  "customer_id": "1234567890",
  "start_date": "2026-02-01",
  "end_date": "2026-02-28",
  "reason": "February activity audit"
}

hopkin google activities get --customer-id 1234567890 --start-date 2026-02-01 --end-date 2026-02-28

With MCC login

{
  "customer_id": "1234567890",
  "login_customer_id": "9876543210",
  "reason": "Review changes on managed account"
}

hopkin google activities get --customer-id 1234567890 --login-customer-id 9876543210

Specific asset activity

{
  "customer_id": "1234567890",
  "asset_ids": [
    "123456789",
    "987654321"
  ],
  "reason": "Check recent changes to specific assets"
}

hopkin google activities get --customer-id 1234567890 --asset-ids 123456789,987654321