CalendarAPIEasily expose your calendars via modern APIs.

CalendarAPI parses iCal (.ics) files and serves them over gRPC and REST. It supports hot config reloads via Viper and comes with a Home Assistant add-on.

Get Started →GitHub Releases →

Why CalendarAPI?

A modern, hackable API layer for your calendars.

Parse iCal (.ics) files from URLs or local paths

CalendarAPI reads `.ics` files directly from remote or local sources, keeping your workflow flexible.

Exposes events via REST and gRPC APIs

Modern API endpoints make it easy to query and integrate calendar data into any stack.

Rule engine for filtering and relabeling events

A powerful built-in engine to filter, relabel, and skip events based on your custom rules.

Hot config reloads via Viper

No restarts needed — changes to your config are picked up live using Viper.

Home Assistant Add-On

Easily deploy CalendarAPI into your smart home using the official HomeAssistant Add-On.

Custom status messages for displays

Set dynamic status messages per calendar — perfect for e-Paper displays or presence indicators.

CLI client for querying and scripting

Use the CLI to fetch calendars, set statuses, and integrate CalendarAPI into your shell workflows.

Minimal footprint, deploy anywhere

Lightweight Go binary runs on containers, Raspberry Pi, or any Linux host with minimal resources.