App Logo
calendar.google.com

Set Google Calendar out of office

Automatically set Google Calendar out of office on calendar.google.com. Create an out-of-office entry on the signed-in Google Calendar's primary calendar for a date range, with an optional custom decline message. New and existing meetings in that range are declined automatically unless declineMeetings is set false. Google offers out of office only on work or school (Google Workspace) accounts: on a personal account the run fails with a message that says so. A rehearsal mode (dry_run) fills the entry in and stops before saving.

Input

endDate required

End date, YYYY-MM-DD (inclusive)

startDate required

Start date, YYYY-MM-DD (inclusive)

account optional

The Google account to set it on, when this browser is signed in to several: its email, or its number in this browser ("1"), as mail.google.com/list_accounts lists them. It must be a work or school account. The run fails, writing nothing, if that account is not signed in. Omit for the first signed-in account.

dry_run optional

When true the entry is filled in (dates, decline setting and message) and the run stops on the step before the one that saves it. Nothing is written, and saved comes back false.

message optional

Custom decline message. Omit to keep Google's own default wording.

declineMeetings optional

Automatically decline new and existing meetings during this time. Defaults to true, matching Google Calendar's own default. Declining notifies the people who invited you.

Output

saved required

True once the composer closed after saving, and after confirming the decline when meetings are being declined.

endDate required
startDate required
dryRun optional
account optional

Email of the Google account used.

message optional

The custom decline message this run was asked to set, or null when Google's default wording was kept.

composerReady optional
messageApplied optional

Whether the message was read back from the field and matched just before saving. Google does not show the decline message anywhere after saving, so this is the furthest it can be checked; it does not prove the server kept it.

declineMeetings optional

FAQ

Create an out-of-office entry on the signed-in Google Calendar's primary calendar for a date range, with an optional custom decline message. New and existing meetings in that range are declined automatically unless declineMeetings is set false. Google offers out of office only on work or school (Google Workspace) accounts: on a personal account the run fails with a message that says so. A rehearsal mode (dry_run) fills the entry in and stops before saving.
Ask an AI agent connected to Reduck to run reduck/calendar.google.com/set_out_of_office, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/calendar.google.com/set_out_of_office
You do not need one. "Set Google Calendar out of office" drives the real calendar.google.com pages in a browser, so it works whether or not calendar.google.com offers an API for this.
Required: startDate, endDate. Optional: account, dry_run, message, declineMeetings.
It returns saved, dryRun, account, endDate, message, startDate, composerReady, messageApplied, declineMeetings.
Yes. It acts as you on calendar.google.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the calendar.google.com cookies saved by the Reduck extension.
It makes changes on calendar.google.com, like sending, posting, booking or buying something.
Ask an AI agent connected to Reduck to run reduck/calendar.google.com/set_out_of_office, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/calendar.google.com/set_out_of_office
It is part of Reduck's official curated catalogue.

Related scripts

calendar.google.com

Create a Google Calendar event

Create an event on the signed-in Google Calendar's primary calendar. Optionally invite guests (each gets an invitation email; external guests are auto-confirmed). Returns the new event's id, which you can pass to delete_event. A Google Meet link may be auto-added, depending on the account's default.

calendar.google.com

List Google Calendar events

List the signed-in Google Calendar account's events between two dates, across every calendar shown in the sidebar, or one calendar with calendarId (from list_calendars). Each occurrence of a repeating event is its own row, with recurring_event_id set to its series. Returns n and events (id, eid, title, all_day, start, end, timezone, location, description, calendar, organizer, attendees with response status, created, html_link). Times are UTC; all-day events use dates, with an exclusive end. One call covers up to one year. Pass eid to get_event, update_event, delete_event, add_conference_link or respond_invitation. Google Tasks and birthdays are not included.

calendar.google.com

Delete a Google Calendar event

Delete an event from the signed-in Google Calendar by its eid (the handle returned by list_events / create_event) or an event link. Guests are sent a cancellation notice. Single (non-recurring) events only; a recurring event is not supported. Irreversible.

Start building not clicking

Get started for free