Hey everyone! Love the package tracking discussion here. Wanted to share some major updates to the Mail and Packages integration that bring full end-to-end package lifecycle tracking — completely local, no third-party API, no subscription fees.
These will be available once they merge my PR but you can also check my fork if you can’t wait.
For those unfamiliar, Mail and Packages connects to your email via IMAP and automatically detects shipping notifications from 13 carriers: USPS, UPS, FedEx, DHL, Amazon, Canada Post, Royal Mail, Hermes/Evri, Australia Post, Poczta Polska, InPost, DPD, and GLS. It also supports USPS Informed Delivery camera images.
What’s New: Package Registry + Tracker Dashboard
The integration now includes a persistent Package Registry that tracks every package through its full lifecycle:
Detected → In Transit → Out for Delivery → Delivered → Cleared
Packages are automatically registered as they’re found in your email, and their status updates with each scan. The registry persists across restarts and exposes everything as sensor attributes — so you can build automations around delivery events.
Along with the registry, there’s a brand new Package Tracker custom card:
type: custom:mailandpackages-tracker
name: Package Tracker
Drop it on a Panel mode view and you get a full-page tracking dashboard with:
-
Status-grouped sections — Out for Delivery, In Transit, Detected, Delivered (collapsible)
-
Expandable package rows — tap to see carrier, source, timestamps, confirmation status
-
“Track on [Carrier]” links — opens the carrier’s tracking page directly
-
Interactive management — Add Package, Mark Delivered, Clear, Clear All Delivered buttons that call HA services
-
Exception indicators — red warning icon for packages with delivery problems
-
Dark theme support — uses HA CSS variables throughout
-
Mobile responsive — works great on phones and tablets
The Summary Card Got Better Too
The existing summary card (custom:mailandpackages-card) now supports all 13 carriers with badge icons, and has a new show_registry_totals option that displays tracked/in-transit/delivered counts at a glance:
type: custom:mailandpackages-card
name: Mail
show_registry_totals: true
entity_usps_mail: true
entity_usps_packages: true
entity_ups_packages: true
entity_fedex_packages: true
entity_packages_in_transit: true
entity_packages_delivered: true
Why This Approach?
-
100% local — no cloud API, no third-party service, no account needed
-
Free — no subscription tiers, no per-shipment limits
-
Privacy-first — your tracking data never leaves your network
-
Automatic detection — no manual entry needed (though you can add packages manually too)
-
13 carriers — broad coverage out of the box, with universal email scanning for others
-
Full HA integration — sensors, service calls, events for automations
Installation
Integration:
Available via HACS — search for “Mail and Packages” or add the repo as a custom repository.
Custom Card:
Add the card repo as a custom HACS repository (Type: Dashboard), then search for “Mail and Packages”.
After installing, enable the Package Registry in the integration’s settings (Settings → Integrations → Mail and Packages → Configure → Advanced Settings).
Links
Integration: 
Custom Card: Would love to hear your feedback! If you run into any issues, feel free to open an issue on GitHub. Happy tracking!
