Skip to content

Package tracking in Home Assistant

A suite of Home Assistant custom integrations that track your packages across carriers and countries — every one of them speaking the same canonical parcel contract, so your automations and dashboards work the same no matter who delivers.

Browse the carriers Get started

How the pieces fit

  • Carrier integrations

    One per carrier, each fully standalone. Talks to its own API and normalises the result into the shared parcel shape and ParcelStatus values.

    See all carriers

  • Parcel Aggregator (optional)

    Only if you run several carriers. Reads what they already publish and re-emits it merged: summed sensors, one next_delivery, one event stream.

    Set it up · On GitHub

  • The contract

    Eight status values, one parcel shape, four events. The thing that makes a carrier-agnostic automation possible at all.

    Read the contract

  • Cookbook

    Ready-to-paste automations and dashboard cards, generated from the examples that ship with the aggregator.

    Automations · Dashboard cards

Missing your carrier?

That is the most useful thing you can tell us. Open a carrier request — writing the code is rarely the blocker, getting real tracking data to confirm the status vocabulary is. A request from someone who actually receives those parcels is worth a great deal.

Support the project

Every integration here is free and MIT-licensed, and stays that way. Sponsoring covers what keeping the suite running actually costs — and if that is not for you, the ways to help that cost nothing are worth as much.

Sponsor on GitHub Buy me a coffee

Independent project

Community-built, MIT-licensed, with no affiliation with or endorsement by any parcel carrier. See the disclaimer.