Calendar Feed (iCal)
App · 5 actions
Read any calendar shared as an iCal link, from Google Calendar, Outlook, Apple Calendar or a school, team or booking calendar: list events, get the next one, check if you're busy. Start a workflow when an event is added or about to start.
Actions
| Action | What it does |
|---|---|
| Check if busy | Find out whether anything on the calendar overlaps a span of time, such as before booking a meeting. |
| Get calendar details | Get a calendar's name, description, time zone and how many events it holds. |
| Get events on a day | Get every event on one day, such as today, in a time zone. |
| Get next event | Get the event happening now or starting next, within a year. |
| List events | List a calendar's events between two times, earliest first, with repeating events expanded. |
Check if busy
Find out whether anything on the calendar overlaps a span of time, such as before booking a meeting. Events marked as free don't count.
Inputs
- Calendar link
calendar_urltextRequired - The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
- From
startdate and time - The start of the span. Defaults to now.
- Until
enddate and time - The end of the span. Defaults to a minute after 'From'.
- Count all-day events
include_all_daytrue/false - Count all-day events as busy too. Off by default, as calendar apps do.Default:
false.
Outputs
busytrue/false- True if anything overlaps the span
countnumber- How many events overlap it
eventslist- The events, earliest first
Example output
{
"busy": true,
"count": 1,
"events": [
{
"all_day": false,
"categories": [],
"description": "Daily check-in",
"end": "2026-10-29T09:45:00-04:00",
"end_utc": "2026-10-29T13:45:00Z",
"location": "Room 4",
"organizer": "Sam Lee",
"recurring": true,
"start": "2026-10-29T09:30:00-04:00",
"start_utc": "2026-10-29T13:30:00Z",
"status": "confirmed",
"time_zone": "America/New_York",
"title": "Team standup",
"uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
"url": ""
}
]
}Get calendar details
Get a calendar's name, description, time zone and how many events it holds.
Inputs
- Calendar link
calendar_urltextRequired - The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
Outputs
descriptiontext- Its description
event_countnumber- How many events it holds, counting a repeating event once
nametext- The calendar's name
repeating_event_countnumber- How many of them repeat
time_zonetext- Its time zone
Example output
{
"description": "Team meetings and time off",
"event_count": 42,
"name": "Team",
"repeating_event_count": 3,
"time_zone": "America/New_York"
}Get events on a day
Get every event on one day, such as today, in a time zone.
Inputs
- Calendar link
calendar_urltextRequired - The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
- Day
daydate - The day. Defaults to today.
- Time zone
time_zonetext - The time zone the day is in, such as America/New_York. Defaults to the calendar's own.
Outputs
calendar_nametext- The calendar's name
countnumber- How many events
daytext- The day (YYYY-MM-DD)
eventslist- The events, earliest first
time_zonetext- The time zone the day was read in
Example output
{
"calendar_name": "Team",
"count": 1,
"day": "2026-10-29",
"events": [
{
"all_day": false,
"categories": [],
"description": "Daily check-in",
"end": "2026-10-29T09:45:00-04:00",
"end_utc": "2026-10-29T13:45:00Z",
"location": "Room 4",
"organizer": "Sam Lee",
"recurring": true,
"start": "2026-10-29T09:30:00-04:00",
"start_utc": "2026-10-29T13:30:00Z",
"status": "confirmed",
"time_zone": "America/New_York",
"title": "Team standup",
"uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
"url": ""
}
],
"time_zone": "America/New_York"
}Get next event
Get the event happening now or starting next, within a year.
Inputs
- Calendar link
calendar_urltextRequired - The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
- Containing
searchtext - Only an event whose title, description or location contain these words.
Outputs
all_daytrue/false- True for an all-day event
calendar_nametext- The calendar's name
categorieslist- Its categories, if any
descriptiontext- Its description
endtext- When it ends: for an all-day event, the day after its last day
end_utctext- When it ends, in UTC (ISO 8601)
foundtrue/false- False if no event is coming up
locationtext- Where it is
organizertext- Who organised it, if the calendar says
recurringtrue/false- True if it is one occurrence of a repeating event
starttext- When it starts: a date for an all-day event, otherwise a date and time with its UTC offset
start_utctext- When it starts, in UTC (ISO 8601)
statustext- confirmed or tentative
time_zonetext- The time zone its times are in
titletext- The event's title
uidtext- The event's ID in the calendar; every occurrence of a repeating event shares it
urltext- A link the event carries, if any
Example output
{
"all_day": false,
"calendar_name": "Team",
"categories": [],
"description": "Daily check-in",
"end": "2026-10-29T09:45:00-04:00",
"end_utc": "2026-10-29T13:45:00Z",
"found": true,
"location": "Room 4",
"organizer": "Sam Lee",
"recurring": true,
"start": "2026-10-29T09:30:00-04:00",
"start_utc": "2026-10-29T13:30:00Z",
"status": "confirmed",
"time_zone": "America/New_York",
"title": "Team standup",
"uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
"url": ""
}List events
List a calendar's events between two times, earliest first, with repeating events expanded.
Inputs
- Calendar link
calendar_urltextRequired - The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
- From
startdate and time - The earliest time to include. Defaults to now.
- Until
enddate and time - The latest time to include. Defaults to 30 days after 'From'.
- Containing
searchtext - Only events whose title, description or location contain these words.
- How many
limitnumber - The most events to return. Defaults to 25.From 1 to 500.
Outputs
calendar_nametext- The calendar's name
countnumber- How many events
eventslist- The events, earliest first
Example output
{
"calendar_name": "Team",
"count": 1,
"events": [
{
"all_day": false,
"categories": [],
"description": "Daily check-in",
"end": "2026-10-29T09:45:00-04:00",
"end_utc": "2026-10-29T13:45:00Z",
"location": "Room 4",
"organizer": "Sam Lee",
"recurring": true,
"start": "2026-10-29T09:30:00-04:00",
"start_utc": "2026-10-29T13:30:00Z",
"status": "confirmed",
"time_zone": "America/New_York",
"title": "Team standup",
"uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
"url": ""
}
]
}