`google_ads_list_audiences`

List Google Ads Audiences

Google

Description

List audience lists (user lists) for a Google Ads account. Returns Customer Match lists, remarketing audiences, rule-based audiences, similar audiences, and lookalike segments. Shows list names, types, sizes (for Search and Display), membership status, and match rates. Supports filtering by type and membership status, plus name search.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_list_audiences",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "Audit all audience lists on the account"
    }
  }
}

hopkin google audiences list

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
`--type`	`array`	Optional	Filter by audience type(s). Examples: CRM_BASED, REMARKETING, RULE_BASED, LOOKALIKE
`--membership-status`	`string`	Optional	Filter by membership status: OPEN (accepting new members) or CLOSED
`--search`	`string`	Optional	Case-insensitive search filter applied to audience list names
`--limit`	`integer`	Optional	Number of lists per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response

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

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 (6)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`type`	`array`	Optional	Filter by audience type(s). Examples: CRM_BASED, REMARKETING, RULE_BASED, LOOKALIKE
`membership_status`	`string`	Optional	Filter by membership status: OPEN (accepting new members) or CLOSED `OPEN` `CLOSED`
`search`	`string`	Optional	Case-insensitive search filter applied to audience list names
`limit`	`integer`	Optional	Number of lists per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1

Examples

All audiences

{
  "customer_id": "1234567890",
  "reason": "Audit all audience lists on the account"
}

hopkin google audiences list --customer-id 1234567890

Customer Match only

{
  "customer_id": "1234567890",
  "type": [
    "CRM_BASED"
  ],
  "reason": "View Customer Match lists and match rates"
}

hopkin google audiences list --customer-id 1234567890 --type CRM_BASED

Search by name

{
  "customer_id": "1234567890",
  "search": "remarketing",
  "reason": "Find remarketing audiences by name"
}

hopkin google audiences list --customer-id 1234567890 --search remarketing