About
Hermes is a Marketplace integration that tracks Hermes (Germany, Hermes Paket) parcels in Home Assistant. Parcels can be followed by entering tracking codes, which needs no account, or by logging in with a Hermes account so incoming parcels are discovered automatically. It adds sensors for incoming parcels, parcels awaiting pickup, the next delivery, delivered parcels and the last successful update, plus a Deliveries calendar and a refresh button. Actions to track and untrack a parcel by its code are available, and device triggers fire when a parcel is registered, changes status, is delivered or has its expected delivery time changed. Options cover filtering delivered parcels by recent days or count, and an optional per-parcel status history that is off by default. It relies on the vendor's cloud and is set up in the UI, and the account source uses an interface that is not a public API and may stop working.
Automatic summary of the README and code of ha-parcel-integrations/ha-hermes. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Device triggers Its devices can start automations directly.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Set up Hermes account
- Username
- Password
Reauthenticate Hermes
- Password
After setup
- Add a parcelEnter a Hermes tracking code to start tracking it. You find it on the shipping confirmation or the missed-delivery card.
- Remove parcels
- Filter byShow delivered parcels from the last X days, or limit to the X most recent.
- AmountNumber of days or parcels to show.
- Include status historyAdd a per-parcel history attribute listing each status update (timestamp, status, original text). Off by default.
- Tracking codes
- Filter by
- Delivered parcels: amount
- Include status history
Texts from the code of ha-parcel-integrations/ha-hermes.
Entities
- ButtonsRefresh
- CalendarsDeliveries
- SensorsIncoming parcels, Awaiting pickup, Next delivery, Delivered parcels, Last successful update
Actions
- Track parcelStart tracking a parcel by its Hermes tracking code.Fields: Tracking code
- Untrack parcelStop tracking a parcel by its Hermes tracking code.Fields: Tracking code
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
📦 Part of ha-parcel-integrations, a family of package-tracking integrations for Home Assistant that all publish the same parcel format, statuses and events, so they plug into cross-carrier automations and the optional Parcel Aggregator. Browse the other carriers on the website.
💬 Questions or feedback? Join the discussion on the Home Assistant community.
- Track any number of Hermes parcels by tracking code — no account needed
- Or add a Hermes account and have its incoming parcels discovered automatically
- Per-parcel sensor with the canonical status (registered / in_transit / out_for_delivery / delivered / …), the carrier's own status text and a tracking deep-link
- Summary sensors: incoming parcels, next delivery, recently delivered parcels
- Read-only Deliveries calendar with the expected delivery windows
- hermes.track_parcel / hermes.untrack_parcel services, so a dashboard button can add a parcel
- Events + device triggers for no-code automations (parcel registered, status changed, delivered, delivery time changed)
- Opt-in per-parcel status history
- Manual refresh button and a diagnostic last-update sensor
Shows in Vulpo
Button card, Calendar card, Chart card, Apple Watch.Information
- Installs
- 150 sharing analytics
- GitHub stars
- 5
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- 1.3.2,
- Category
- Productivity and information, Calendars and to-dos
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
hermes- Issues
- Report an issue
