Aliexpress Package Tracker for Home Assistant (Marketplace integration)

Installs: 353 sharing analytics
GitHub stars: 110
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: 2.9.7, October 6, 2026
Category: Productivity and information, Shopping and groceries
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: aliexpress_package_tracker
Source: github.com/yohaybn/HA_aliexpress_package_tracker_sensor
Issues: Report an issue

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

Screenshots From the README of yohaybn/HA_aliexpress_package_tracker_sensor.

About

Aliexpress Package Tracker is an integration that tracks AliExpress packages through Cainiao Global tracking data. It adds sensors that show the current status of each package, and it needs the vendor's cloud to fetch updates. Tracking numbers are added, removed and retitled through Home Assistant actions, and they persist across restarts. Duplicate numbers are merged, the real tracking number is pulled from the Cainiao data, and order links are built when the data allows it. A custom event fires whenever a package changes state, which can drive automations such as notifications, and a dashboard card is bundled with the integration. Setup is done in the UI, with options for language and automatic deletion of delivered packages after a set number of days.

Automatic summary of the README and code of yohaybn/HA_aliexpress_package_tracker_sensor. 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.
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

Setting it up

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

Configure AliExpress Tracker

Preferred Language
Automatically delete after X days when status is 'Delivered'
Number of days before deletion

After setup

Preferred Language
Automatically delete after X days when status is 'Delivered'
Number of days before deletion

Texts from the code of yohaybn/HA_aliexpress_package_tracker_sensor.

Actions

Add TrackingAdd a new tracking number to AliExpress Package Tracker.Fields: Tracking Number, Title
Remove TrackingRemove a tracking number from AliExpress Package Tracker.Fields: Tracking Number
Edit TitleChange the title attribute of a specific AliExpress tracking entity.Fields: Entity ID, New Title

From the README

This Home Assistant custom component provides sensor entities to track your packages from AliExpress using Cainiao Global tracking. It allows you to add and remove tracking numbers via Home Assistant services and provides detailed package status information.
This integration now includes the Custom Lovelace Card automatically!
Tracking Package Status: Displays the current status of your AliExpress packages.
Service Calls:
aliexpress_package_tracker.add_tracking: Adds a new tracking number.
aliexpress_package_tracker.remove_tracking: Removes an existing tracking number.
Automatic Updates: Periodically updates package information.
Storage: Persists tracking numbers across Home Assistant restarts.
Duplicate Tracking Number Handling: Automatically resolves and merges duplicate tracking numbers.
Real Tracking Number Extraction: Extracts the real tracking number from Cainiao data.
Order URL Generation: Generates direct order URLs from tracking data if exists.
Event Firing: Fires a custom event (aliexpress_package_data_updated) on state changes.
Built-in Lovelace Card: Includes a beautiful custom card to display your packages without extra installation.