Plugin PostNL Package Tracking
Posted: Saturday 19 September 2026 15:49
Hi all,
I'd like to announce the first release (v1.0.0) of a new plugin: PostNL Package Tracking. It shows your incoming and outgoing PostNL shipments (Track & Trace) from your own PostNL account directly in Domoticz.
GitHub: https://github.com/MadPatrick/domoticz_postnl
What it does
Logs in to your PostNL account (jouw.postnl.nl) and reads your tracked shipments
Creates Text devices with your incoming, delivered and sent packages, one line per package, for example: [06/08] bol: In transit 11:00-13:30
Also creates a "Packages in transit" counter and a "Delivered Today" switch
Shows delivered packages for a configurable number of days
Device text in English or Dutch
Configurable poll interval (minimum 15 minutes)
Requirements
Clone or copy the plugin into your Domoticz plugins folder
Restart Domoticz
Add hardware "PostNL Package Tracking" and enter your PostNL e-mail address and password
Important notes
PostNL has no public API. The plugin uses an unofficial, reverse-engineered login flow (based on the Toon app "postnl"). If PostNL changes their login process, the plugin may stop working until it is updated.
Please don't poll too often, to avoid your account being flagged.
Your credentials are only sent to PostNL itself.
Dashticz users
I have also built a matching PostNL widget for Dashticz, which shows incoming and sent packages in one tile.
This is the first release, so expect some rough edges. I would really like your feedback:
Does the login work for you?
Are there shipment types or statuses that are shown wrong or not at all?
Bugs, errors in the Domoticz log, or anything that is unclear
I'm also open to ideas for extensions: more languages, other devices or notifications, or anything else you'd like to see. Let me know here or open an issue on GitHub.
Thanks, and happy tracking!
I'd like to announce the first release (v1.0.0) of a new plugin: PostNL Package Tracking. It shows your incoming and outgoing PostNL shipments (Track & Trace) from your own PostNL account directly in Domoticz.
GitHub: https://github.com/MadPatrick/domoticz_postnl
What it does
Logs in to your PostNL account (jouw.postnl.nl) and reads your tracked shipments
Creates Text devices with your incoming, delivered and sent packages, one line per package, for example: [06/08] bol: In transit 11:00-13:30
Also creates a "Packages in transit" counter and a "Delivered Today" switch
Shows delivered packages for a configurable number of days
Device text in English or Dutch
Configurable poll interval (minimum 15 minutes)
Requirements
- - A PostNL account
- Python module requests (pip3 install requests)
- Domoticz with Extended Plugin Settings
Clone or copy the plugin into your Domoticz plugins folder
Restart Domoticz
Add hardware "PostNL Package Tracking" and enter your PostNL e-mail address and password
Important notes
PostNL has no public API. The plugin uses an unofficial, reverse-engineered login flow (based on the Toon app "postnl"). If PostNL changes their login process, the plugin may stop working until it is updated.
Please don't poll too often, to avoid your account being flagged.
Your credentials are only sent to PostNL itself.
Dashticz users
I have also built a matching PostNL widget for Dashticz, which shows incoming and sent packages in one tile.
This is the first release, so expect some rough edges. I would really like your feedback:
Does the login work for you?
Are there shipment types or statuses that are shown wrong or not at all?
Bugs, errors in the Domoticz log, or anything that is unclear
I'm also open to ideas for extensions: more languages, other devices or notifications, or anything else you'd like to see. Let me know here or open an issue on GitHub.
Thanks, and happy tracking!
