Skip to content
Chris edited this page Jul 19, 2020 · 27 revisions

About Mail and Packages integration

The Mail and Packages integration creates sensors for supported shippers to show a snapshot of mail and packages that are scheduled to be delivered the current day. It provides a count of in transit and delivered packages that are scheduled to be delivered the current day. It also generates the number of USPS mail pieces and provides a rotating GIF of the USPS provided images of the mail, if available, for the current day.

How it works

From your instance of HASS, the Mail and Packages integration connects to the email account you supply where your shipment notifications are sent. It reviews at the subject lines of the current day's emails from the shipping companies and counts the subject lines that match known language from the shipping companies about their transit status. For USPS Informed delivery emails, it also downloads the mail images to combine them into a rotating GIF.

  • All procedures are done locally on your machine.
  • No external services are used to process your email.
  • No data is sent outside of your local instance of Home Assistant

Search Terms

Shipper Email Subject Body Text Tracking Number
USPS USPSInformedDelivery@usps.gov Informed Delivery Daily Digest none n/a
USPS auto-reply@usps.com Expected Delivery on out for delivery Subject
USPS auto-reply@usps.com Item Delivered none n/a
UPS mcinfo@ups.com UPS Update: Package Scheduled for Delivery Today "Tracking Number" Body / Subject
UPS mcinfo@ups.com UPS Update: Follow Your Delivery on a Live Map "Tracking Number" Body / Subject
UPS mcinfo@ups.com Your UPS Package was delivered none n/a
FEDEX TrackingUpdates@fedex.com Delivery scheduled for today none n/a
FEDEX TrackingUpdates@fedex.com Your package is scheduled for delivery today none Subject
FEDEX TrackingUpdates@fedex.com Your package has been delivered none n/a
Amazon shipment-tracking@amazon.com none "will arrive:" Subject
Amazon shipment-tracking@amazon.ca none "will arrive:" Subject
DHL donotreply_odd@dhl.com DHL On Demand Delivery "scheduled for delivery TODAY" Body
DHL donotreply_odd@dhl.com DHL On Demand Delivery "has been delivered" n/a
Clone this wiki locally