This is a custom component for Home Assistant to integrate Aula.
-
Installable and updatable through the Home Assistant Marketplace (formerly HACS)
-
UI config flow
-
School schedules as Home Assistant calendars
-
Booked meetings (skole-hjem-samtaler, forældresamtaler) as Home Assistant calendars (opt-in)
-
"Ugeplaner/Ugenoter" from "Min Uddannelse", "Meebook", "EasyIQ" and "Docendo"
-
"Opgaver" (assignments) from "Min Uddannelse", including the teacher's notes, see Opgaver
-
Messages - if there are unread messages, we turn a binary sensor on and populate it with the message details.
-
"Huskelisten" (reminders) from "Systematic", see Huskelisten
-
Use the builtin
aula.api_callservice to interact directly with Aula's API, see Service."Ugeplaner/ugenoter/huskelisten" are stored as sensor attributes. Can be rendered like:
{{ state_attr("sensor.hojelse_skole_emilie", "ugeplan") }}And visualized in your dashboard with the markdown card:
type: markdown content: '{{ state_attr("sensor.hojelse_skole_emilie", "ugeplan") }}' title: Ugeplan for Emilie
Another example using vertical-stack and collapsable-cards:
type: vertical-stack
cards:
- type: custom:collapsable-cards
title: Ugeplan Emilie
cards:
- type: markdown
content: '{{ state_attr("sensor.hojelse_skole_emilie", "ugeplan") }}'
- type: custom:collapsable-cards
title: Ugeplan Emilie, næste uge
cards:
- type: markdown
content: '{{ state_attr("sensor.hojelse_skole_emilie", "ugeplan_next") }}'
- type: custom:collapsable-cards
title: Ugeplan Rasmus
cards:
- type: markdown
content: '{{ state_attr("sensor.hojelse_skole_rasmus", "ugeplan") }}'
- type: custom:collapsable-cards
title: Ugeplan Rasmus, næste uge
cards:
- type: markdown
content: '{{ state_attr("sensor.hojelse_skole_rasmus", "ugeplan_next") }}'- Lots of small fixes and optimizations
Home Assistant 2026.11 and newer ships with the Marketplace (the successor of HACS), under Settings > Marketplace. The Aula repository is available there.
- Open Settings > Marketplace.
- Search for and download the "Aula" integration.
- Restart Home Assistant.
On Home Assistant older than 2026.11 the same catalog is available through the HACS custom integration.
- Download the latest release.
- Unpack the release and copy the custom_components/aula directory into the custom_components directory of your Home Assistant installation.
- Restart Home Assistant.
- Go to Settings -> Integrations -> Add Integration
- Search for "Aula" and follow the instructions in the config flow.
You must log in with the guardian's MitID; childlogin is not supported.
- Enter your MitID username. You then approve the login in the MitID app.
- If you use a MitID token device instead, the flow asks for your MitID password and the code from the token device.
- If several MitID identities are found, you pick the one to use for Aula.
- Choose which features to enable (school schedule, ugeplaner, Min Uddannelse assignments, booked meetings). You can change this later under Configure.
Aula issues a refresh token that Home Assistant renews automatically and stores, so you stay logged in across restarts. Only when the refresh token has expired or is revoked does Home Assistant ask you to re-authenticate in the integration card: approve MitID once more, no need to delete the integration.
For each child the integration creates (names depend on the child's first name and your school):
| Entity | Purpose |
|---|---|
sensor.<school>_<child> |
Main sensor with the weekly plans, assignments and reminders as attributes |
calendar.skoleskema_<child> |
School schedule (opt-in) |
calendar.ugeplan_<child> |
Lessons from EasyIQ and Docendo (see Ugeplaner) |
calendar.samtaler_<child> |
Booked meetings (opt-in) |
calendar.fodselsdage_<child> |
Birthdays |
binary_sensor.aula_aulamessage |
On when there are unread messages, with the message details as attributes |
If two or more of your children are in the same class, every one of them gets the class's lessons in their own schedule.
Enable "booked meetings" when adding the integration, or later under the integration's
Configure options. Each child then gets a calendar.samtaler_<name> calendar with
the time you booked for every skole-hjem-samtale and forældresamtale in Aula — only
your own booked slot, not the whole booking period, and not other families' slots.
Events are titled with the child's first name, e.g. "Emilie: Skole-hjem-samtale".
Meetings are looked up 100 days ahead and refreshed every 30 minutes. A meeting you have
not booked a time for yet does not appear.
Enable "ugeplaner" when adding the integration, or later under Configure. The integration picks the ugeplan source from the widgets your school has enabled in Aula:
| Source | Aula widget |
|---|---|
| Min Uddannelse | 0029 / 0023 |
| Meebook | 0004 |
| EasyIQ | 0001 / 0128 / 0142 |
| Docendo | 0057 |
This week's and next week's plan are stored in the ugeplan and ugeplan_next
attributes of the child's sensor. For EasyIQ and Docendo, lessons are also added to the
child's "Ugeplan " calendar.
Docendo: Docendo returns one weekplan per class. The plan is matched to a child by the class shown in Aula (e.g. "4I"), ignoring case, spaces and punctuation. With one child, an unmatched plan is still shown; with several children, a plan that matches none of their classes is skipped (logged at debug level). Docendo plans are refreshed every 30 minutes.
EasyIQ "Generelt om ugen": On EasyIQ SkolePortal (widget 0128), the teachers' weekly
letter ("Generelt om ugen") is put at the top of ugeplan / ugeplan_next under its own
heading. It is also added to the "Ugeplan " calendar as an all-day event, Monday to
Friday, with the letter as plain text in the description. Weeks without a letter are unchanged.
Ugeplaner are read through the same unofficial widget endpoints that Aula's own web page uses, and can change without notice. If an update breaks them, you can go back to the previous version in the Marketplace (Aula → ⋮ → Redownload → pick the version).
Enable "assignments from Min Uddannelse" when adding the integration, or later under Configure. This needs the Min Uddannelse assignments widget in Aula (0030, or 0023 at schools that do not expose 0030 to guardians). If your school has neither, the integration logs an error and shows no assignments.
For the current and next ISO week, each child's sensor gets:
mu_opgaver/mu_opgaver_next: the assignments as HTML, including the teacher's notes (indhold), ready for a markdown card.mu_opgaver_data/mu_opgaver_next_data: the same as structured lists withid,titel,dato,ugedag,fagandindhold, for use in templates and automations.
The notes are fetched from the Min Uddannelse web API. If that fails, the assignments are still shown, just without notes.
type: markdown
title: Opgaver for Emilie
content: '{{ state_attr("sensor.hojelse_skole_emilie", "mu_opgaver") }}'Schools that use Systematic's "Huskelisten" widget (0062 in Aula) get the child's reminders (homework and team reminders) in the huskelisten attribute of the child's sensor.
Makes a custom call to Aula's API with your login. uri is the part after the API base URL, e.g. ?method=presence.updatePresenceTemplate. Without post_data the call is a GET; with JSON post_data it is a POST. A POST can change data in Aula, so use it with care. See services.yaml for a full example.
- You must use the guardian MitID; childlogin is not supported.
- Ugeplaner and assignments are read through unofficial endpoints and can break when the provider changes them.
- Entity names contain your school's name (e.g.
sensor.hojelse_skole_emilie) and differ from the examples in this README.
Join our Discord https://discord.gg/SnfRg3DWG6 and feel free to ask in #homeassistant

