Notification Dispatcher – centralized notification routing for Home Assistant

Share your Projects! Custom Integrations
, , , ,
1

Notification Dispatcher – centralized notification routing for Home Assistant

Hi everyone,

I recently started experimenting with Home Assistant custom integrations and decided to follow an idea I had for a while using AI assistance.

To be completely transparent:
I am not an experienced Python developer and I’m definitely not a Home Assistant integration expert. Most of this project was built by iterating on ideas together with AI and learning along the way. Still, I wanted to share it because the result is already working surprisingly well in my own setup and maybe others find it useful too.

The project is called:

Notification Dispatcher

GitHub:

The main goal is to centralize notification delivery logic instead of directly calling notify.mobile_app_* services everywhere.

Why I built this

My automations started becoming messy because notifications depend on many conditions:

  • who should receive them
  • who is home
  • time of day
  • workdays vs weekends
  • DND/sleeping hours
  • notification severity
  • fallback recipients
  • multiple devices per person

I wanted a single dispatcher that decides who actually receives a notification.

Features

  • Manage people directly in the Home Assistant UI

  • Assign:

    • person.* entities
    • one or multiple notify.* targets

  • Notification types:

    • critical
    • warning
    • info
    • reminder

  • Separate weekday/weekend schedules

  • DND support

  • Optional “only when home”

  • Optional fallback recipient

  • Critical notifications bypass restrictions

  • Persistent notifications for warnings and critical alerts

  • Pass-through support for mobile app notification data

Example

action: notification_dispatcher.send
data:
  title: "Garage"
  message: "Garage door is still open."
  type: warning
  target: all

Target a specific person:

action: notification_dispatcher.send
data:
  title: "Laundry"
  message: "Washing machine finished."
  type: reminder
  target: johannes

Dry-run mode:

action: notification_dispatcher.send
response_variable: dispatcher_result
data:
  title: "Test"
  message: "This would be delivered like this."
  type: info
  target: all
  dry_run: true

Installation

HACS

Add as custom repository:

https://github.com/jesterrace-666/ha-notification-dispatcher

Category:
Integration

Feedback welcome

I’m mainly looking for:

  • ideas
  • criticism
  • edge cases
  • architectural improvements
  • suggestions from people who know Home Assistant internals better than I do

Since this is my first bigger HA integration project, I fully expect there are things that can be improved significantly.

Maybe the idea itself is useful to others as well.