Google Ads / API Reference
gads_add_keywords
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. Add keywords to a Google Ads ad group. Args: adgroup_id: Ad group ID to add keywords to (required). keywords_json: JSON array of keyword objects, e.g. '[{"text": "running shoes", "match_type": "BROAD", "cpc_bid_micros": 800000}]' (required). match_type options: BROAD, PHRASE, EXACT. campaign_id: Parent campaign ID (required). customer_id: Google Ads customer ID. Leave blank to use default.
This is a write tool: it adds keywords in your Google Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Add keywords in my Google Ads account for [adgroup id], [keywords json], [campaign id].
It takes 3 required and 1 optional parameter.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
adgroup_id | string | Yes | Adgroup Id |
keywords_json | string | Yes | Keywords Json |
campaign_id | string | Yes | Campaign Id |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_add_keywords_to_shared_listgads_add_ad_group_age_rangegads_add_ad_group_carriergads_add_ad_group_gendergads_add_ad_group_income_rangegads_add_ad_group_keyword
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: