# Calendar Feed (iCal)

> 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.

App · 5 actions. Web page: https://docs.lodol.com/docs/integrations/ical-feed

## Actions

### 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_url`, text, required): 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 (`start`, date and time): The start of the span. Defaults to now.
- Until (`end`, date and time): The end of the span. Defaults to a minute after 'From'.
- Count all-day events (`include_all_day`, true/false): Count all-day events as busy too. Off by default, as calendar apps do. Default: `false`.

**Outputs**

- `busy` (true/false): True if anything overlaps the span
- `count` (number): How many events overlap it
- `events` (list): The events, earliest first

**Example output**

```json
{
  "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_url`, text, required): 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**

- `description` (text): Its description
- `event_count` (number): How many events it holds, counting a repeating event once
- `name` (text): The calendar's name
- `repeating_event_count` (number): How many of them repeat
- `time_zone` (text): Its time zone

**Example output**

```json
{
  "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_url`, text, required): 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 (`day`, date): The day. Defaults to today.
- Time zone (`time_zone`, text): The time zone the day is in, such as America/New_York. Defaults to the calendar's own.

**Outputs**

- `calendar_name` (text): The calendar's name
- `count` (number): How many events
- `day` (text): The day (YYYY-MM-DD)
- `events` (list): The events, earliest first
- `time_zone` (text): The time zone the day was read in

**Example output**

```json
{
  "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_url`, text, required): 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 (`search`, text): Only an event whose title, description or location contain these words.

**Outputs**

- `all_day` (true/false): True for an all-day event
- `calendar_name` (text): The calendar's name
- `categories` (list): Its categories, if any
- `description` (text): Its description
- `end` (text): When it ends: for an all-day event, the day after its last day
- `end_utc` (text): When it ends, in UTC (ISO 8601)
- `found` (true/false): False if no event is coming up
- `location` (text): Where it is
- `organizer` (text): Who organised it, if the calendar says
- `recurring` (true/false): True if it is one occurrence of a repeating event
- `start` (text): When it starts: a date for an all-day event, otherwise a date and time with its UTC offset
- `start_utc` (text): When it starts, in UTC (ISO 8601)
- `status` (text): confirmed or tentative
- `time_zone` (text): The time zone its times are in
- `title` (text): The event's title
- `uid` (text): The event's ID in the calendar; every occurrence of a repeating event shares it
- `url` (text): A link the event carries, if any

**Example output**

```json
{
  "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_url`, text, required): 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 (`start`, date and time): The earliest time to include. Defaults to now.
- Until (`end`, date and time): The latest time to include. Defaults to 30 days after 'From'.
- Containing (`search`, text): Only events whose title, description or location contain these words.
- How many (`limit`, number): The most events to return. Defaults to 25. From 1 to 500.

**Outputs**

- `calendar_name` (text): The calendar's name
- `count` (number): How many events
- `events` (list): The events, earliest first

**Example output**

```json
{
  "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": ""
    }
  ]
}
```
