Vacationplanner calendar subscriptions

This service turns Vacationplanner vacations into an iCalendar subscription for Apple Calendar and other calendar applications.

Usage

Add a calendar subscription using the following URL. Replace YOUR_API_TOKEN with your Vacationplanner API token and URL-encode its value.

https://vacationplanner.popov.link/calendar.ics?token=YOUR_API_TOKEN

token

Required: your Vacationplanner API token.

years

Optional: comma-separated years. The default is the current UTC year and the next year. Up to 10 distinct years from 1 to 9998 are accepted; duplicate years are removed.

To select years explicitly:

https://vacationplanner.popov.link/calendar.ics?token=YOUR_API_TOKEN&years=2026,2027,2028

The calendar application controls the refresh interval. Occasional requests from several devices are supported; frequent requests may be rate limited. Keep the subscription URL private.

Privacy and self-hosting

Self-hosting is recommended. Do not blindly trust any hosted instance, including this one. The subscription URL contains your API token. Service operators and providers that terminate HTTPS can read it. HTTPS does not hide the token from those operators.

The service does not store calendars or log requests. Query-string logging is disabled on this server, but this does not guarantee privacy across the infrastructure. Prefer a server you control and replace the host in the example URLs with your own.

The repositories below contain source code, ready-made container image links and self-hosting instructions.

Repository locations: canonical source · github · read-only mirror