`google_ads_list_ad_groups`

List Google Ads Ad Groups

Google

Description

List ad groups for a Google Ads account. Supports filtering by campaign, status, search, and pagination. Results are cached; pass refresh=true for latest data.

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_list_ad_groups",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "List ad groups"
    }
  }
}

hopkin google ad-groups 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
`--campaign`	`string`	Optional	Filter by campaign ID (optional)
`--ad-group-id`	`string`	Optional	Get a specific ad group by ID. When provided, returns only that ad group and ignores other filters/pagination.
`--ad-group-ids`	`array`	Optional	Get multiple ad groups by ID. Mutually exclusive with ad_group_id. When provided, ignores other filters/pagination.
`--search`	`string`	Optional	Search ad groups by name (case-insensitive partial match)
`--status`	`array`	Optional	Filter by ad group status: ENABLED, PAUSED, REMOVED
`--limit`	`integer`	Optional	Number of ad groups per page (default: 20, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response
`--refresh`	`boolean`	Optional	Force fresh data from Google Ads API instead of using cache. Defaults to false (cache-first). Only set to true when you need real-time data.

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

List all
Filter by campaign
Get by ID
Search
Get multiple by ID
Filter by status

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

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountspattern: ^[\d-]+$
`campaign_id`	`string`	Optional	Filter by campaign ID (optional)pattern: ^\d+$
`ad_group_id`	`string`	Optional	Get a specific ad group by ID. When provided, returns only that ad group and ignores other filters/pagination.pattern: ^\d+$
`ad_group_ids`	`array`	Optional	Get multiple ad groups by ID. Mutually exclusive with ad_group_id. When provided, ignores other filters/pagination.
`search`	`string`	Optional	Search ad groups by name (case-insensitive partial match)minLength: 1
`status`	`array`	Optional	Filter by ad group status: ENABLED, PAUSED, REMOVED
`limit`	`integer`	Optional	Number of ad groups per page (default: 20, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1
`refresh`	`boolean`	Optional	Force fresh data from Google Ads API instead of using cache. Defaults to false (cache-first). Only set to true when you need real-time data.

Examples

List all

{
  "customer_id": "1234567890",
  "reason": "List ad groups"
}

hopkin google ad-groups list --customer-id 1234567890

Filter by campaign

{
  "customer_id": "1234567890",
  "campaign_id": "9876543210",
  "reason": "List ad groups in campaign"
}

hopkin google ad-groups list --customer-id 1234567890 --campaign 9876543210

Get by ID

{
  "customer_id": "1234567890",
  "ad_group_id": "5555555555",
  "reason": "Get ad group details"
}

hopkin google ad-groups list --customer-id 1234567890 --ad-group-id 5555555555

Search

{
  "customer_id": "1234567890",
  "search": "brand",
  "reason": "Find brand ad groups"
}

hopkin google ad-groups list --customer-id 1234567890 --search brand

Get multiple by ID

{
  "customer_id": "1234567890",
  "ad_group_ids": [
    "111",
    "222",
    "333"
  ],
  "reason": "Get details for specific ad groups"
}

hopkin google ad-groups list --customer-id 1234567890 --ad-group-ids 111,222,333

Filter by status

{
  "customer_id": "1234567890",
  "status": [
    "ENABLED"
  ],
  "reason": "List enabled ad groups"
}

hopkin google ad-groups list --customer-id 1234567890 --status ENABLED