`google_ads_get_account_summary`

Get Google Ads Account Summary

Google

Description

Quick account-level performance overview — the preferred first call when the user asks how an account is doing, for a performance summary, or for account totals over a date range. Returns pre-aggregated standardized metrics (spend, impressions, clicks, CTR, CPC, conversions, CPA, ROAS) in one call, plus the supported Demand Gen Platform Comparable conversion family and a per-conversion-action breakdown. Metrics are normalized to be identical to meta_ads_get_account_summary for cross-platform comparison. Use google_ads_get_performance_report only when a level (campaign/ad group) or segment (date/device/network) breakdown is needed, and google_ads_get_insights only for custom metric selection. Accepts login_customer_id for MCC-managed accounts. Always fetches fresh data.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "google_ads_get_account_summary",
    "arguments": {
      "customer_id": "1234567890",
      "reason": "Quick performance overview"
    }
  }
}

hopkin google account-summary 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
`--date-preset`	`string`	Optional	Predefined date range: TODAY, YESTERDAY, LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH
`--date-range`	`object`	Optional	Custom date range {start_date, end_date} in YYYY-MM-DD
`--connection-id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

{
  "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)maxLength: 20, pattern: ^[\d-]+$
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (4)

Name	Type	Required	Description
`login_customer_id`	`string`	Optional	MCC (Manager) Customer ID; required for managed accountsmaxLength: 20, pattern: ^[\d-]+$
`date_preset`	`string`	Optional	Predefined date range: TODAY, YESTERDAY, LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH `TODAY` `YESTERDAY` `LAST_7_DAYS` `LAST_30_DAYS` `THIS_MONTH` `LAST_MONTH`
`date_range`	`object`	Optional	Custom date range {start_date, end_date} in YYYY-MM-DD
`connection_id`	`string`	Optional	Optional ID of a specific connection to use for this call. Omit to use the actor's default connection for this network. Call <platform>_list_connections to discover available connection IDs.

Examples

Last 30 days summary

{
  "customer_id": "1234567890",
  "reason": "Quick performance overview"
}

hopkin google account-summary get --customer-id 1234567890

Last 7 days

{
  "customer_id": "1234567890",
  "date_preset": "LAST_7_DAYS",
  "reason": "Weekly check-in"
}

hopkin google account-summary get --customer-id 1234567890 --date-preset LAST_7_DAYS

With MCC

{
  "customer_id": "1234567890",
  "login_customer_id": "9876543210",
  "date_preset": "LAST_30_DAYS",
  "reason": "Managed account overview"
}

hopkin google account-summary get --customer-id 1234567890 --login-customer-id 9876543210 --date-preset LAST_30_DAYS