Google Ads / API Reference

`google_ads_keyword_forecast`

Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Forecast clicks, impressions, and cost for a list of keywords using Keyword Planner. Args: customer_id: Google Ads customer ID keywords: Comma-separated keywords to forecast average_cpc_micros: Target CPC in micros (1_000_000 = $1.00) language_id: Language criterion ID (1000=English) country_code: Two-letter ISO country code, e.g. 'US', 'IL', 'GB' (default: 'US'). A numeric geo target constant ID such as '2376' is also accepted. forecast_days: Length of the forecast window in days, starting tomorrow (default: 30). Keyword Planner only forecasts future periods, up to a year out.

This is a read-only tool: it returns keyword forecast 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:

Keyword forecast in my Google Ads account for [keywords].

It takes 2 required and 4 optional parameters.

Parameters

Parameter	Type	Required	Description
`customer_id`	string	Yes	Customer Id
`keywords`	string	Yes	Keywords
`average_cpc_micros`	integer	No	Average Cpc Micros
`language_id`	string	No	Language Id
`country_code`	string	No	Country Code
`forecast_days`	integer	No	Forecast Days

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 free — 30 tool calls a month

No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.