API Reference

Google Ads / API Reference

gads_account_overview

Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. Get high-level account metrics: total spend, impressions, clicks, conversions, CTR, avg CPC, ROAS. Args: start_date: Start date YYYY-MM-DD. Defaults to 28 days ago. end_date: End date YYYY-MM-DD. Defaults to today. customer_id: Google Ads customer ID. Leave blank to use default.

This is a read-only tool: it returns account overview for your Google Ads account. It changes nothing.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Account overview in my Google Ads account.

It takes 0 required and 3 optional parameters.

Parameters

ParameterTypeRequiredDescription
start_datestringNoStart Date
end_datestringNoEnd Date
customer_idstringNoCustomer Id

Related Google Ads tools

Before you can call it

This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads