The usps platform allows one to track deliveries and inbound mail from the US Postal Service (USPS). In addition to having a USPS account, you will need to complete the “Opt-In” process for packages by clicking “Get Started Now” on this page. You must also “Opt-In” to Informed Delivery to see inbound mail.

To enable this component, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
    username: YOUR_USERNAME
    password: YOUR_PASSWORD

You will see two new sensors, one for packages and one for mail and a camera to rotate through images of incoming mail for the current day.

Configuration options for the USPS component:

  • username (Required): The username to access the MyUSPS service.
  • password (Required): The password for the given username.
  • name (Optional): Prefix for sensor names (defaults to “USPS”)

The USPS sensor logs into the MyUSPS website to scrape package data. It does not use an API.