Track package deliveries using the Parcel app API. View active and recent deliveries, add new tracking numbers, get delivery status updates and events. Use when the user asks about packages, parcels, deliveries, tracking numbers, shipments, or delivery status.
Track package deliveries using the Parcel app API. View delivery status, tracking events, and manage tracking numbers.
Before using this Skill, you must:
cd scripts && npm install && npm run build
Obtain a Parcel app API key from web.parcelapp.net (requires premium subscription)
Set the API key environment variable:
export PARCEL_API_KEY="your-api-key-here"
To retrieve delivery information:
node scripts/dist/view-deliveries.js --filter recent
Filter modes:
active - Only show deliveries currently in transitrecent - Show recent deliveries including completed ones (default)Examples:
Get active deliveries:
node scripts/dist/view-deliveries.js --filter active
Get all recent deliveries:
node scripts/dist/view-deliveries.js
Each delivery object includes:
tracking_number - Package tracking identifiercarrier_code - Carrier identifier (e.g., "ups", "fedex", "usps")description - User-provided delivery descriptionstatus_code - Numeric status indicator (0-8)events - Array of tracking events with timestamps and locationsdate_expected - Expected delivery date/time (if available)date_expected_end - Delivery window end time (if available)extra_information - Additional carrier-specific dataStatus codes:
Event object structure:
event - Event descriptiondate - Event timestamplocation - Event location (optional)additional - Extra information (optional)To add a new tracking number:
node scripts/dist/add-delivery.js --tracking <number> --carrier <code> --description <text>
Required parameters:
--tracking or -t - Tracking number--carrier or -c - Carrier code (see "Getting Carrier Codes" below)--description or -d - Delivery descriptionOptional parameters:
--language or -l - Two-letter language code (default: "en")--push or -p - Send push notification when delivery is addedExamples:
Add UPS delivery:
node scripts/dist/add-delivery.js -t 1Z999AA10123456784 -c ups -d "Office supplies"
Add placeholder delivery:
node scripts/dist/add-delivery.js --tracking 12345 --carrier pholder --description "Unknown carrier" --push
Add delivery with language preference:
node scripts/dist/add-delivery.js -t ABC123 -c dhl -d "Documents" --language de
To retrieve the list of supported carriers:
node scripts/dist/get-carriers.js
This returns a JSON array with carrier codes and names. Common carriers include:
ups - UPSusps - USPSfedex - FedExdhl - DHLamazon - Amazon Logisticspholder - Placeholder (for unknown carriers)The carrier list is updated daily and does not require authentication.
Filter carriers:
node scripts/dist/get-carriers.js | jq '.[] | select(.code=="ups")'
View Deliveries:
Add Delivery:
Get Carriers:
--filter active to see only in-transit packagesget-carriers.js before adding deliveries to ensure correct carrier codepholder when the carrier is unknown# Get all active deliveries
node scripts/dist/view-deliveries.js --filter active
# Check specific status (filter in your code or with jq)
node scripts/dist/view-deliveries.js --filter active | jq '.[] | select(.status_code==3)'
# Get carrier code
node scripts/dist/get-carriers.js | jq '.[] | select(.name | contains("UPS"))'
# Add delivery
node scripts/dist/add-delivery.js -t 1Z999AA10123456784 -c ups -d "Holiday gift" --push
# View to confirm
node scripts/dist/view-deliveries.js --filter active
# Get delivery with expected date
node scripts/dist/view-deliveries.js --filter active | jq '.[] | {description, date_expected, status_code}'
"Missing required environment variable: PARCEL_API_KEY"
export PARCEL_API_KEY="your-key"echo $PARCEL_API_KEY"API request failed: 401"
"API request failed: 429"
Empty deliveries array
add-delivery.js"No data available" after adding delivery
Invalid carrier code
get-carriers.js to see supported carrierspholder if carrier is not supportedFor detailed API documentation, see references/API.md.
For setup instructions, see references/SETUP.md.