API Reference

Google Ads / API Reference

google_ads_set_ad_schedule

Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Add day-parting schedule entries to a campaign. Each schedule entry restricts when ads can show and optionally adjusts bids. To replace the full schedule, first use google_ads_clear_ad_schedule. Args: campaign_id: Campaign ID. schedules: List of schedule dicts. Each must have: - day: MONDAY|TUESDAY|WEDNESDAY|THURSDAY|FRIDAY|SATURDAY|SUNDAY - start_hour: int 0-23 - end_hour: int 1-24 - bid_modifier: float (optional, default 1.0; 0.5 = -50%, 1.5 = +50%) customer_id: Google Ads customer ID. Leave blank to use default. Example: schedules=[ {"day": "MONDAY", "start_hour": 8, "end_hour": 18}, {"day": "TUESDAY", "start_hour": 8, "end_hour": 18, "bid_modifier": 1.2} ]

This is a write tool: it sets ad schedule 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:

Set ad schedule in my Google Ads account for [campaign id], [schedules].

It takes 2 required and 1 optional parameter.

Parameters

ParameterTypeRequiredDescription
campaign_idstringYesCampaign Id
schedulesarrayYesSchedules
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