HiveDAV

HiveDAV is a small, curlable free/busy scheduler that reads availability from a CalDAV calendar, stores it locally, and exposes a simple HTTP (curl) interface for availability and booking. It is designed to be run as a standalone service and is configured via environment variables.

Key Features

• Curl-first HTTP interface for querying week/day availability and simple booking commands.
• CalDAV discovery and calendar fetching to import events and compute free/busy slots.
• Local sqlite database storage for availability (single-file app.db) with atomic update flow.
• Ability to create bookings and send iCalendar invites via configured SMTP (supports STARTTLS).
• Simple build and deployment tooling: Makefile, Dockerfile present; runnable via go run . or containerized builds.

Use Cases

• Provide a minimal, scriptable free/busy endpoint for teams that already use CalDAV calendars.
• Automate room or resource booking by querying availability via curl and creating iCal invites.
• Integrate calendar availability into lightweight websites, chatbots or shell scripts that need a curlable scheduler.

Limitations and Considerations

• Uses the mattn/go-sqlite3 driver which requires gcc/CGO (CGO_ENABLED=1) to build; this affects static binary builds and cross-compilation.
• CalDAV servers vary in supported REPORT/query behavior; HiveDAV fetches all events and normalizes availability locally to maximize compatibility.

HiveDAV is a pragmatic tool for teams wanting a minimal, self-hosted free/busy service that interoperates with existing CalDAV calendars and simple curl-based workflows. It focuses on robustness with a small dependency surface and straightforward configuration.