`google_ads_list_accounts`

List Google Ads Accounts

Google

Description

List Google Ads accounts accessible by the user, including MCC child accounts. When calling other tools for MCC child accounts, you MUST pass login_customer_id with the parent MCC Customer ID. Results are cached; pass refresh=true for latest data. To list only children of a specific MCC, use google_ads_list_mcc_child_accounts instead.

Read-onlyOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_list_accounts",
    "arguments": {
      "reason": "List all ad accounts"
    }
  }
}

hopkin google accounts list

Flag	Type	Required	Description
`--customer-id`	`string`	Optional	Get a specific account by Customer ID. When provided, returns only that account and ignores other filters/pagination.
`--customer-ids`	`array`	Optional	Get multiple accounts by Customer ID. Mutually exclusive with customer_id. When provided, ignores other filters/pagination.
`--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.
`--cursor`	`string`	Optional	Pagination cursor from previous response
`--search`	`string`	Optional	Search accounts by name (case-insensitive partial match)
`--limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100)

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

List all
Get by ID
Search by name
Get multiple by ID
Force refresh

Parameters

Name	Type	Required	Description
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (6)

Name	Type	Required	Description
`customer_id`	`string`	Optional	Get a specific account by Customer ID. When provided, returns only that account and ignores other filters/pagination.pattern: ^[\d-]+$
`customer_ids`	`array`	Optional	Get multiple accounts by Customer ID. Mutually exclusive with customer_id. When provided, ignores other filters/pagination.
`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.
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1
`search`	`string`	Optional	Search accounts by name (case-insensitive partial match)minLength: 1
`limit`	`integer`	Optional	Number of accounts per page (default: 20, max: 100)min: 1, max: 100

Examples

List all

{
  "reason": "List all ad accounts"
}

hopkin google accounts list

Get by ID

{
  "customer_id": "1234567890",
  "reason": "Get account details"
}

hopkin google accounts list --customer-id 1234567890

Search by name

{
  "search": "marketing",
  "reason": "Find marketing accounts"
}

hopkin google accounts list --search marketing

Get multiple by ID

{
  "customer_ids": [
    "1234567890",
    "0987654321"
  ],
  "reason": "Get details for specific accounts"
}

hopkin google accounts list --customer-ids 1234567890,0987654321

Force refresh

{
  "refresh": true,
  "reason": "Get fresh data"
}

hopkin google accounts list --refresh true