Posti Delivery Calendar

A Home Assistant integration that tracks Posti mail delivery days for your Finnish postal code.

Posti no longer delivers mail every weekday — delivery days vary by postal code and week. This integration fetches the upcoming delivery days from Posti's public API and exposes them in Home Assistant.

Entities

For each configured postal code you get one device with two entities:

Entity	Type	Description
Delivery days	Calendar	An all-day event on each upcoming mail delivery day (~2 weeks ahead)
Mail delivery today	Binary sensor	on if today is a mail delivery day. Attributes: next_delivery, delivery_dates

The data refreshes every 6 hours, and the binary sensor re-evaluates at midnight.

Installation

HACS (recommended)

1. In HACS, open ⋮ → Custom repositories
2. Add https://github.com/taysuus/hass-posti-delivery-calendar with type Integration
3. Search for Posti Delivery Calendar in HACS and install it
4. Restart Home Assistant

Manual

1. Copy the custom_components/posti_delivery folder into your Home Assistant config/custom_components/ directory
2. Restart Home Assistant

Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for Posti Delivery Calendar
3. Enter your five-digit Finnish postal code (e.g. 00100)

You can add the integration multiple times for different postal codes.

Example automation

automation:
  - alias: "Notify on mail delivery day"
    triggers:
      - trigger: time
        at: "08:00:00"
    conditions:
      - condition: state
        entity_id: binary_sensor.posti_00100_mail_delivery_today
        state: "on"
    actions:
      - action: notify.mobile_app_your_phone
        data:
          message: "Mail is delivered today 📬"

Data source

Data comes from Posti's public mail delivery day API: https://www.posti.fi/maildelivery-api-proxy/?q=<postal code>

This is an unofficial integration and is not affiliated with or endorsed by Posti.

License

MIT