booked-scheduler

Automate Booked Scheduler resource reservations and availability queries via API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dmd/dotfiles --skill booked-scheduler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: booked-scheduler
Source: https://github.com/dmd/dotfiles/tree/main/claude/skills/booked-scheduler
Command: npx skills add https://github.com/dmd/dotfiles --skill booked-scheduler

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

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.

Frequently Asked Questions about booked-scheduler

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate room bookings via the Booked Scheduler API?

Automate room bookings via the Booked Scheduler API by using a Python client library that handles authentication, deduplication, and pagination to list resources, check availability, and create or update reservations. It manages recurring rules and participant quirks automatically.

Can I import ICS calendar events into Booked Scheduler?

You can import ICS calendar events into Booked Scheduler using a dedicated conversion script that transforms ICS datetimes into timezone-aware ISO8601 formats, parses RRULE into Booked recurrence objects, and maps CATEGORIES to custom attributes.

What authentication is required for Booked Scheduler API automation?

Booked Scheduler API automation requires either an API key providing api_id:api_key authentication or session fallback credentials. You configure these credentials before running scripts to query schedules, manage reservations, or perform admin operations.

Does the Booked Scheduler automation handle recurring reservations and participant updates?

Yes, the Booked Scheduler automation handles recurring reservations by converting RRULE syntax into native recurrence objects. It also manages participants by performing follow-up reservation updates to add attendees after the initial booking.

How do I query paginated reservation data from Booked Scheduler without hitting limits?

Query paginated reservation data from Booked Scheduler by using helper scripts that automatically split large queries into manageable pages. The API client handles pagination internally, ensuring complete reservation retrieval without hitting request limits.

Can I perform admin operations like managing users and groups with Booked Scheduler API scripts?

Yes, you can perform admin operations for users, groups, and accessories using the Booked Scheduler API scripts. The client supports listing resources, approving or checking-in reservations, and executing administrative tasks programmatically.