Paket Tracker for Home Assistant (Marketplace integration)

On Home Assistant 2026.10 or older? Open it in HACS

Installs: 130 sharing analytics
GitHub stars: 41
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v0.3.49, November 6, 2026
Category: Productivity and information, Shopping and groceries
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: parcel_tracker
Source: github.com/SoerenKaiser99/parcel_tracker
Issues: Report an issue

Shows in Vulpo Quick Toggle card, Calendar card, Chart card, Apple Watch, Control Center.

Download Vulpo

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of SoerenKaiser99/parcel_tracker.

Die Paket-Tracker-Karte im hellen Design: zwölf Pakete von DHL, DPD, GLS, Hermes, UPS, Amazon, eBay, AliExpress und 17track mit Status, Fortschrittsbalken und Liefertermin, im Kopf der Schalter „Geschenkmodus“ und ein Paket als Geschenk mit Geschenkbox

Die Karte mit geöffneter Eingabe für eine neue Sendung und einem aufgeklappten DHL-Paket: Verlauf der Sendung, die Sendungsnummer mit dem Symbol „Sendung verfolgen“ dahinter und die Knöpfe „Details über 17track holen“, „Erhalten“, „Umbenennen“ und „Löschen“

Die Paket-Tracker-Karte im dunklen Design

About

Paket Tracker follows parcels from DHL, DPD, GLS, Hermes and UPS in Home Assistant, along with orders found in emails. Amazon, eBay and AliExpress orders are picked up from a dedicated mailbox read over IMAP, and everything is shown on its own dashboard card. It adds a calendar of delivery dates, sensors for parcels today, on the way, ready for pickup and delivered, and a gift mode that hides parcel names on a shared dashboard. Parcels can be added, renamed, marked as received, assigned to a person or sent to 17track through actions. Device triggers cover out for delivery, delivered, ready for pickup and problems, and notifications can go to the person who owns the parcel. It is set up in the UI, uses the vendor's cloud for live status, and shows repair notices for rejected keys or logins.

Automatic summary of the README and code of SoerenKaiser99/parcel_tracker. Something wrong, or are you the maintainer and want your own text here? Get in touch

Shows in Vulpo

Quick Toggle card, Calendar card, Chart card, Apple Watch, Control Center.

Download Vulpo

Supports

Uses the vendor's cloudNeeds an internet connection and an account with the vendor.
Device triggersIts devices can start automations directly.
From the MarketplaceInstalled through the Marketplace, formerly HACS.
Actively maintainedIts author released or pushed a change in the last six months.

Provides

Switches
Sensors
Calendars

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Parcel Tracker

DHL API key (optional)
CountryDecides how many digits the postcode has and which GLS lookup is asked.
Postcode (optional)Germany: 5 digits (e.g. 10115). Austria and Switzerland: 4 digits (e.g. 1010).
Hide delivered parcels after (days)

DHL API key rejected

DHL API key

After setup

DHL API key (optional)Without a key, DHL parcels come from the DHL mails via the mail import; with it you get the live status. Leave empty to keep the saved key.
Remove DHL API keyTick and save to delete the saved DHL key. The tick wins, even if a new key is typed in the field above.
17track API key (optional)Free key from api.17track.net (200 numbers once). Only used when you ask for it on the card. Leave empty to keep the saved key.
Remove 17track API keyTick and save to delete the saved 17track key. The tick wins, even if a new key is typed in the field above.
CountryDecides how many digits the postcode has and which GLS lookup is asked.
Postcode (optional)Germany: 5 digits (e.g. 10115). Austria and Switzerland: 4 digits (e.g. 1010).
Hide delivered parcels after (days)
Hide namesParcels are only named after the carrier (e.g. “DHL-Paket”, “Amazon-Bestellung”) – on the card, in the calendar, in the sensors and in the notifications. For gifts on a shared dashboard. A name you typed in yourself stays visible; the stored names are not changed.
Mail import enabledSwitching it off removes the saved username and password.
IMAP server
PortUsual ports: 993 encrypted, 143 unencrypted. Choosing another connection does not change the port.
Connection"Encrypted (TLS, default)" fits every mail provider. The other two are only for a mail server in your own network, e.g. a self-hosted server with a self-signed certificate: with a provider on the internet the password could be read or the server impersonated.
UsernameLeave empty to keep the saved username.
PasswordLeave empty to keep the saved password.
FolderThe folder of the mailbox that is read – only this one. Keep "INBOX" for a dedicated parcel mailbox. A folder of your main mailbox works too, but then Home Assistant knows the password of that whole mailbox. Leave empty to keep the stored folder.
Person set upChange or remove a person set up here, also one no longer in Home Assistant.
PersonSet up a new person. Leave both empty to only save the fields below.
Unclear parcels belong toEveryone (as before) or one of the persons set up here.
Shared addresses (belong to everyone)Addresses that belong to several persons, e.g. family@… Parcels to these addresses belong to everyone.
Addresses (one per line)The person's own mail address, their forwarding address (e.g. parcels+name@…) or the sender address when forwarding by hand. To remove all addresses, remove the person.
NotifyNotifications about this person's parcels only go here. Empty: to the general targets.
Remove personRemoves the addresses and notifications of this person.

Texts from the code of SoerenKaiser99/parcel_tracker.

Entities

CalendarsParcels
SensorsParcels today, Parcels on the way, Parcels possible today, Parcels delivered today, Parcels ready for pickup, 17track quota
SwitchesGift mode

Actions

Add parcelStart tracking a parcel.
- Tracking number
- Carrier
- Name
- Owner
Remove parcelStop tracking a parcel.
- Tracking number
Rename parcelChange a parcel's label.
- Tracking number
- Name
Mark as receivedMark a parcel as received by hand: it counts as delivered from now on and stays so. For orders without a delivery mail and parcels whose "delivered" never arrives.
- Tracking number
RefreshPoll now, including the mailbox if configured.
- Tracking number
Mark as giftMark a parcel, or all parcels not delivered yet, as a gift, or make it visible again (marking is open to everyone, only making it visible again is limited to people who may see gifts).
- Tracking number
- All open parcels
- Gift
- Gift for
Set ownerHand a parcel to a person, or to everybody. A mail never changes an owner set this way.
- Tracking number
- Person
Track via 17trackSend a parcel to 17track to add place, time window and history. Uses 1 of your 17track numbers.
- Tracking number

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.
Repair noticesNotices it can show in Settings, Repairs:DHL API key rejected, Tracking not working, Parcel mailbox login rejected, Parcel mailbox is read without verified encryption, Amazon mails not recognised, UPS credentials rejected, UPS monthly budget used up, 17track API key rejected, 17track quota almost used up, 17track quota used up, Add the Paket Tracker card to the dashboard resources

From the README

Ausführliche Anleitung mit Rezepten: soerenkaiser99.github.io/parcel_tracker · Alle Versionen: CHANGELOG
Home-Assistant-Integration, die Pakete von DHL, DPD, GLS, Hermes und (optional) UPS verfolgt, Amazon-, eBay- und AliExpress-Bestellungen sowie Eventim-Tickets mit Postversand aus E-Mails übernimmt und alles auf einer eigenen Dashboard-Karte zeigt.

From the README of SoerenKaiser99/parcel_tracker, MIT License. Shortened.