Google Ads / API Reference
google_ads_add_search_term_as_negative
Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Add a search term directly as a negative keyword — one-click workflow from the search terms report. Must specify at least one target: campaign_id, adgroup_id, or shared_set_id. Args: customer_id: Google Ads customer ID. search_term: The search term text to add as a negative (e.g. 'free shipping'). match_type: Match type for the negative: BROAD, PHRASE, or EXACT. campaign_id: Add as campaign-level negative to this campaign. adgroup_id: Add as ad-group-level negative to this ad group (requires campaign_id too). shared_set_id: Add to this shared negative keyword list instead.
This is a write tool: it adds search term as negative 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 search term as negative in my Google Ads account for [search term], [match type].
It takes 3 required and 3 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | Yes | Customer Id |
search_term | string | Yes | Search Term |
match_type | string | Yes | Match Type |
campaign_id | string | No | Campaign Id |
adgroup_id | string | No | Adgroup Id |
shared_set_id | string | No | Shared Set Id |
Related Google Ads tools
google_ads_add_adgroup_negative_keywordsgoogle_ads_add_audience_to_campaigngoogle_ads_add_keywordsgoogle_ads_add_location_targetgoogle_ads_add_negative_keywordsgoogle_ads_add_placement_exclusion
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: