cards / calendar-events-card

Calendar events card

A multi-calendar Lovelace card with auto-scaling text, a visual editor, and stable colour mapping. Built because the default calendar card was a single-calendar wall of grey text.

v1.2 · HACS compatible · HA 2024.4+ · MIT
View on GitHub Install →
Live demo · April 2026 data
April 2026
‹›
Mo
Tu
We
Th
Fr
Sa
Su
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
19:00 Gym personal
14:30 F1 sprint f1
19:00 Gym personal

Features

  • Multi-calendar overlay with stable per-calendar colour mapping. Configure once, colours stick across reloads.
  • Auto-scaling text via ResizeObserver. Looks right at any tile size, from full-width to 1×1.
  • Three views: month grid, agenda list, compact strip. Switch in YAML or via the visual editor.
  • Visual editor with drag-reorder for calendars. No YAML required, but every option still YAML-configurable.
  • All-day events handled correctly across DST and timezones. Yes, this took two rewrites.
  • Keyboard navigable, screen-reader friendly. aria-live region for upcoming events.

Install

One-click install via the Home Assistant Community Store. Updates land automatically.

01
Open HACS → Frontend → Custom repositories. Add this URL as type Lovelace: 
https://github.com/squizzer73/calendar-events-card
02
Install calendar-events-card, then add the resource to your Lovelace config (HACS handles this on most setups).
03
Or hit the badge:
HACS Open in My Home Assistant

Configuration

Option Type Default Description
type string required Always custom:calendar-events-card.
entities list required List of calendar.* entities to display.
view string month One of month, agenda, compact.
days_ahead number 14 How many days the agenda view looks forward.
colors map Per-entity hex colour override. Defaults to the auto palette.
title string Card header. Omit to hide.

Changelog

v1.2 21 Apr 2026
  • Auto-scaling text on the events list — never overflows again.
  • Visual editor: drag to reorder calendars, set per-calendar colour.
  • Fix: time zone offset on all-day events spanning DST.
v1.1 08 Apr 2026
  • Multi-calendar support with stable colour mapping.
  • Compact mode for small Lovelace tiles.
  • Fix: today highlight off-by-one when locale week starts on Sunday.
v1.0 29 Mar 2026
  • Initial public release.
  • Month grid + agenda list.
  • HACS-compatible packaging.