About
GLS is a Home Assistant integration that tracks GLS parcels by tracking number, with no GLS account needed. It adds summary sensors for incoming parcels, next delivery, parcels en route to a ParcelShop, parcels awaiting pickup, delivered parcels and the last successful update, plus a deliveries calendar and a refresh button. Parcels can be added or removed through the integration options or through track and untrack actions, using either the parcel number or the short tracking ID. Device triggers fire when a parcel is registered, changes status, is delivered, or has its expected delivery time changed, so automations can start from them. An option can add a per-parcel status history attribute, and another filters delivered parcels by days or by most recent count. Setup is done in the UI by choosing a country and postal code, and the integration relies on the vendor's cloud.
Automatic summary of the README and code of ha-parcel-integrations/ha-gls. 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 GLS
- Country
- Postal code
After setup
- Add a parcelEnter a GLS parcel number or tracking ID to start tracking it. It uses the hub postal code.
- 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
- Delivered parcels: filter by
- Delivered parcels: amount
- Include status history
Texts from the code of ha-parcel-integrations/ha-gls.
Entities
- ButtonsRefresh
- CalendarsDeliveries
- SensorsIncoming parcels, Next delivery, En route to ParcelShop, Awaiting pickup, Delivered parcels, Last successful update
Actions
- Track parcelStart tracking a GLS parcel by its number.Fields: Tracking code, Postal code
- Untrack parcelStop tracking a GLS parcel by its number.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 multiple GLS parcels by tracking number — no account
- Add parcels from the options, a service, or a dashboard button
- Per-parcel sensor per tracked shipment, with full status details as attributes
- Incoming, next-delivery, en-route and awaiting-pickup summary sensors
- Delivered-parcels sensor and an optional per-parcel status history timeline
- Weight and dimensions where GLS provides them
- Automatic lifecycle management — per-parcel sensors appear and disappear as parcels move through delivery
Shows in Vulpo
Button card, Calendar card, Chart card, Apple Watch.Information
- Installs
- 129 sharing analytics
- GitHub stars
- 10
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- 1.14.0,
- Category
- Productivity and information, Shopping and groceries
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
gls- Issues
- Report an issue
