booked-scheduler

What problem does it solve?

This Skill provides programmatic control over a Booked Scheduler deployment (scandium.mclean.harvard.edu) to automate resource discovery, availability checks, reservation creation and updates, and to avoid fragile direct API calls and manual calendar imports.

Core Features & Use Cases

• Robust API client and helpers: Includes a BookedAPI library that handles authentication, session fallbacks, JSON parsing quirks, deduplication, and reservation pagination splitting.
• ICS import and recurrence handling: The ICS import script converts ICS datetimes to timezone-aware ISO8601, parses RRULE into Booked recurrenceRule objects, maps CATEGORIES to custom attributes, and extracts participants and scanned initials.
• End-to-end reservation management: Supports listing resources and schedules, creating/updating/deleting reservations (with follow-up updates to add participants), approving/checking-in/checking-out, and admin operations for users, groups, and accessories; ideal for automating room scheduling and calendar-to-booking workflows.

Quick Start

Run the ics_to_booked.py script to import event.ics into Booked Scheduler for a named resource while SCANDIUM_API_KEY provides api_id:api_key authentication.