---
id: recurring-ical-events
version: "3.8.2"
license: LGPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# recurring-ical-events — Calculate recurrence times of events, todos, alarms and journals based on icalendar RFC5545.

License: copyleft · Maintenance: active · Downloads: 2.4M/mo

## What it is and what it does

This package solves the complexity of iCalendar recurrence by taking raw RFC 5545 calendar data and expanding recurring events, todos, journals, and alarms into their individual occurrences. It handles the full lifecycle: repetitions defined by RRULE, removals via EXDATE, and later edits to specific instances. You pass it a Calendar object from the icalendar library and query for events at a specific date or date range; it returns the expanded list of actual occurrences.

The package wraps six runtime dependencies—icalendar for parsing, python-dateutil for date math, tzdata and x-wr-timezone for timezone handling, typing-extensions for type hints, and backports-zoneinfo for older Python versions. It supports Python 3.8 through 3.14 and is actively maintained. There are no known security vulnerabilities.

Use it for:

- Expand a calendar feed to show all occurrences of a weekly meeting over the next month.
- Retrieve all instances of a recurring todo item to display in a task list.
- Build a scheduling UI that needs to show individual alarm times for a repeating event series.
- Export calendar data to a format that requires flat event lists instead of recurrence rules.
- Query a calendar for all events on a specific date, including those from recurring series.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Expands recurring iCalendar events (RFC 5545) into individual occurrences, handling repetitions, removals, and edits across events, todos, journals, and alarms.

Yes. The package is production-stable, actively maintained, has no known vulnerabilities, and solves a genuine RFC 5545 complexity that most calendar applications need. The LGPL-3.0-or-later license is permissive for most use cases (including proprietary software that doesn't modify the library itself). Install it if you work with iCalendar data and need to expand recurrence rules.

## Install

pip install recurring-ical-events
uv add recurring-ical-events
poetry add recurring-ical-events

## Installing recurring-ical-events

Before you install: Low friction: pure Python wheel, active maintenance (last commit 2026-07-20), production-stable status. Six runtime dependencies are all well-established calendar/timezone libraries.

License in practice: LGPL-3.0-or-later (copyleft): you may use this package freely, but any modifications you distribute must be released under the same or compatible license, and you must disclose the source.

Quickstart:

pip install recurring-ical-events

import recurring_ical_events
from icalendar import Calendar

cal = Calendar.from_ics(ics_string)
events = recurring_ical_events.of(cal).at("2026-08-14")

Requires Python 3.8 or later; depends on icalendar and python-dateutil being installed.

Verify before relying:

- Whether the package handles edge cases in RFC 5545 recurrence rules (RRULE) comprehensively or has known limitations.
- Performance characteristics when expanding events with complex recurrence patterns or very long time ranges.

## Package facts

- License: LGPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 2.4M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

icalendar recurring events, rfc 5545 recurrence expansion, ics calendar event recurrence, icalendar rrule expansion, calendar event series expansion, icalendar todo recurrence, ics alarm recurrence handling, calendar-scheduling, rfc5545-icalendar

[View on SkillFed](https://skillfed.io/packages/recurring-ical-events) · [View on PyPI](https://pypi.org/project/recurring-ical-events/)