Widget

Calendar

A unified agenda that merges your Home Assistant calendars and the device's Apple Calendars into one view. Show it as a scrolling agenda grouped by day or as a traditional month grid with event dots. Tap any event for its time, calendar, and a live map of its location.

What it does

The calendar widget pulls events from one or more Home Assistant calendar entities and, optionally, from this device's Apple Calendars, merges them, and sorts them by start time. Each event shows a colored dot (the calendar's color when available), its title, its time (or "All day"), and a location line when one is set.

The layout resizes smartly. At full size it shows the complete agenda (or month grid); shrink the widget and it sheds detail — first down to today's date plus the next few events, and at its smallest just today's weekday and day number.

Tap an event for details Tapping an event opens a detail sheet with the title, when it happens, which calendar it's on, and — if it has a location — the address geocoded to a pin on a live map. On iPhone/iPad a Directions in Maps button hands off to Apple Maps.

Sources

Events come from two places, blended together:

Home Assistant calendars — any calendar.* entity. Flux reads them over the HA REST API (GET /api/calendars/{entity}). Pick which ones to include in the widget's settings.
Apple Calendars — the calendars on this iPhone/iPad, via EventKit. Turn on Apple Calendar and grant calendar access when asked.

On Apple TV tvOS has no EventKit, so the Apple Tab can't be read on the TV directly. Instead, a paired iPhone/iPad fetches your Apple events and bridges them to the Apple TV over the sync channel, where they're cached and shown. Home Assistant calendars work on the TV on their own. A momentary fetch failure on the phone won't blank the TV — an empty push is ignored.

Styles

Two view styles, set with the View picker:

Agenda (agenda) — events grouped under day headers ("Today", "Tomorrow", then "Wednesday, Jun 17"), scrolling vertically. Covers the next days ahead from today.
Month grid (month) — a classic month calendar with weekday columns and up to three event dots per day. The month view always loads the whole visible month, including earlier days this month, so past-but-this-month events still appear.

Today is marked, not hidden In the month grid, today's date gets an accent ring and a faint tint while the number stays in the normal readable color — so it's legible on any theme or background.

Add an event (iOS)

In the agenda view on iPhone/iPad, a ＋ button in the header opens a quick "New Event" sheet that writes to your default Apple Calendar:

Title — type it, or tap the mic and speak it (live dictation).
All-day toggle and a start date/time picker.
Location with live address & place suggestions from Apple Maps as you type.

Adding events is iOS-only The ＋ "New Event" sheet uses EventKit and writes to an Apple Calendar, so it appears on iPhone/iPad only. The Apple TV shows events but can't create them.

Add it

Enter edit mode, tap Add Widget, choose Calendar ("Agenda from HA + Apple calendars").
Open the widget's inspector (tap the widget while editing).
Pick the view (Agenda or Month grid), then choose which Home Assistant calendars to show.
Turn on Apple Calendar if you want this device's events too (you'll be asked for access).

Settings

Option	What it does
View	Agenda (events grouped by day) or Month grid (month calendar with event dots).
Days ahead	How many days of upcoming events the agenda covers, from 1 to 30. (The month grid loads the whole visible month regardless.)
Tap to open full screen	When on, tapping the widget opens the full-screen calendar tool. On by default.
Apple Calendar	Include this device's Apple Calendar events alongside the HA calendars. Prompts for calendar access.
Accent color	Color for day headers, the today ring, and event dots that have no calendar color.
Font	Type design for the event text: System, Rounded, Serif, or Monospaced.
Title size	Point size of the event title (main text), 11–26.
Subtitle size	Point size of the time / date line (sub text), 8–18.
Text color	Color of the main event text. Leave unset to follow the theme/system color.
Home Assistant Calendars	A toggle per discovered `calendar.*` entity — pick which ones the widget shows.

Trigger automations from events Add a calendar entity as a State trigger in Automations to run actions when an event begins — lights, scenes, announcements, anything.