mcpField
P
parcel-tracking

parcel-tracking

github.com/jezwebProductivity1.1k984 installsUpdated 3w ago
Repository

About parcel-tracking

parcel-tracking is a skill for finding shipment numbers in Gmail dispatch emails and checking delivery progress for Australian and international couriers. It identifies carriers, builds tracking links, and uses available scraping or browser tools to retrieve status when possible.

Key features

  1. 01Searches dispatch emails for tracking numbers
  2. 02Identifies couriers from numbers or email details
  3. 03Builds carrier-specific tracking links
  4. 04Checks live status with available web tools
  5. 05Handles multiple parcels in one search

Use cases

  1. 01Find the tracking number for a recent order
  2. 02Check delivery progress across courier services
  3. 03Track a parcel when only its number is available

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jezweb/claude-skills --skill parcel-tracking

After installing, type/parcel-trackingin Claude Code to confirm it loaded.

Details

From the project README

Parcel Tracking

Find tracking numbers from Gmail dispatch emails and check delivery status for Australian and international couriers.

When to Use

  • "Where's my parcel / package / order?"
  • "Has my [product] arrived / shipped yet?"
  • "Track my order from [store]"
  • "What's the status of my delivery?"
  • "Do I have a tracking number for [item]?"
  • User pastes or mentions a tracking number
  • "Check the StarTrack / AusPost / Aramex / Toll tracking"

Workflow

Step 1: Find the Tracking Number

If the user already provided a tracking number, skip to Step 2.

Otherwise, search Gmail for dispatch emails. Look for recent messages matching:

dispatched OR shipped OR "tracking number" OR "consignment number" newer_than:30d

For a specific store or order, narrow the search:

from:mwave.com.au dispatched
from:amazon.com.au shipped

Read the email body and extract:

  • Tracking / consignment number
  • Carrier name
  • Order number
  • Dispatch date
  • Delivery notes (signature required, etc.)

Gmail access: Use whatever Gmail tool is available (Gmail MCP, gws CLI gws gmail, or ask the user to check manually and paste the tracking number).

Step 2: Identify the Carrier and Build the Tracking Link

Use the table below to identify the carrier from the tracking number format or dispatch email, then build the direct tracking link where possible.

CarrierNumber format / exampleDirect tracking link
AusPost / StarTrackAlphanumeric, e.g. 36VJ65064757, JD123456789AUhttps://auspost.com.au/mypost/track/details/{NUMBER}
Sendle6-8 alphanumeric chars, e.g. SNFJJ3https://track.sendle.com/tracking?ref={NUMBER}
DHL10-12 digits, e.g. 1234567890https://www.dhl.com/au-en/home/tracking.html?tracking-id={NUMBER}
FedEx12-15 digits, or AU+10 digitshttps://www.fedex.com/apps/fedextrack/?tracknumbers={NUMBER}
TNT (now FedEx)9 digits, e.g. 907384999https://www.tnt.com/express/en_au/site/shipping-tools/tracking.html (paste)
UPSStarts with 1Z, 18 charshttps://www.ups.com/track?tracknum={NUMBER}
Aramex (formerly Fastway)Numeric label number, varieshttps://www.aramex.com.au/tools/track (paste)
CouriersPleaseNumeric or CP prefixhttps://www.couriersplease.com.au/tools-track (paste)
Toll / MyTollNumeric consignment, varieshttps://mytoll.com/ (paste)
Team Global ExpressNumeric, varieshttps://myteamge.com/ (paste)
Hunter ExpressAlphanumeric, e.g. AIM478695https://www.hunterexpress.com.au/tracking/ (paste)
Border ExpressNumeric, varieshttps://www.borderexpress.com.au/tracking/ (paste)
Direct Freight ExpressNumeric consignmenthttps://www.directfreight.com.au/ConsignmentStatus.aspx (paste)

Deep-links (tracking number in URL): AusPost/StarTrack, Sendle, DHL, FedEx, UPS.

Form-based (provide link + number separately): Aramex, CouriersPlease, Toll, Team Global Express, Hunter Express, Border Express, Direct Freight Express, TNT.

If carrier is unknown: Default to AusPost (most common in Australia), or ask the user to check their dispatch email.

Step 3: Try to Get Live Status

If web scraping tools are available, try scraping the tracking page:

url: {direct tracking URL}
wait_for: 3000 (many tracking pages are JS-rendered)

Many tracking pages return limited data when scraped. AusPost is particularly JS-heavy. If scraping returns useful status info, include it. If not, just provide the direct link. Don't mention failed scrapes to the user.

If browser automation is available (Chrome MCP, Playwright), navigate to the tracking page and read the status directly.

If no scraping/browser tools are available, skip this step and provide the link.

Step 4: Present Results

Always include:

  1. Current status (from scrape if available, or from dispatch email)
  2. Direct tracking link (always)
  3. Expected delivery window (if known)
  4. Delivery notes (signature required, card-to-collect, etc.)
Example: Carrier with Deep Link
Order IN03069870 — Mac mini x 2
Dispatched by Mwave via AusPost/StarTrack on 17 Mar

Tracking: 36VJ65064757
Status: In transit — processed at Sydney sorting facility
Expected: Thu 19 – Fri 20 Mar
Note: Signature required. If no one home, parcel goes to local post office.

Track live: https://auspost.com.au/mypost/track/details/36VJ65064757
Example: Form-Based Carrier
Order 12345 — [item]
Dispatched via Toll on 15 Mar

Consignment: TXY9876543
Expected: 3-5 business days

Track at: https://mytoll.com/
Paste consignment number: TXY9876543
Handling Multiple Parcels

Search broadly:

(dispatched OR shipped OR "on its way" OR "tracking number") newer_than:30d

Present each parcel as a separate block.

Carrier Contact Numbers (Australia)

CarrierPhoneHours (AEST/AEDT)
AusPost / StarTrack eParcel13 13 18Mon-Fri 8am-6pm
StarTrack (account customers)13 23 45Business hours
CouriersPlease13 00 36 16Business hours
Toll Priority13 15 31Mon-Fri 7am-10pm, Sat-Sun 7am-5pm
Toll IPEC1300 865 547Business hours
Hunter Express02 9780 4099Business hours
DHL13 14 06Business hours
FedEx / TNT13 26 10Business hours
UPS13 26 77Business hours
AramexSee aramex.com.au/contact-usBusiness hours
SendleOnline only (support form)—
Team Global Expressmyteamge.com contact form—

Carrier-Specific Notes

AusPost / StarTrack

  • URL format: https://auspost.com.au/mypost/track/details/{TRACKING_NUMBER} — tracking number goes directly in the path
  • Sparse tracking events after Sydney (Lidcombe/Chullora) processing is normal for regional deliveries
  • Allow up to 24 hours after dispatch for tracking to appear
  • Signature-required parcels go to local post office if undelivered

Sendle

  • Sendle halted all parcel pick-ups in early 2025 and directed customers to Aramex. Existing Sendle shipments still trackable.
  • Deep link: https://track.sendle.com/tracking?ref={SENDLE_REFERENCE}

Toll vs Team Global Express

  • Toll Global Express was sold and rebranded as Team Global Express — different tracking system
  • Domestic Toll parcels (IPEC, Priority, Express) still use MyToll

Tool Flexibility

This skill works with whatever tools are available:

ToolWhat it enables
Gmail access (any MCP or CLI)Search dispatch emails for tracking numbers
Web scraper (any MCP)Attempt live status from tracking pages
Browser automation (Chrome MCP, Playwright)Navigate tracking pages for JS-rendered status
None of the aboveUser provides tracking number, skill provides the correct link

Comments

Markdown supported