mcpField
U
ups-cli

ups-cli

github.com/dl-alexandreOther139 installsUpdated 4w ago
Repository

About ups-cli

ups-cli is a command-line tool for managing UPS shipments, suited to shipping and operations workflows. It covers tracking, rates, labels, pickups, and nearby drop-off locations.

Key features

  1. 01Track individual and batch shipments
  2. 02Review shipment history
  3. 03Query and compare shipping rates
  4. 04Create, void, and reprint labels
  5. 05Schedule or cancel pickups
  6. 06Find nearby UPS locations

Use cases

  1. 01Check delivery status and proof of delivery
  2. 02Compare service rates before shipping
  3. 03Create labels and arrange shipment pickups

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/dl-alexandre/skills --skill ups-cli

After installing, type/ups-cliin Claude Code to confirm it loaded.

Details

From the project README

UPS CLI

Track and manage UPS shipments using the ups command-line tool.

Prerequisites

ups --version
export UPS_API_KEY='your-api-key'
export UPS_USERNAME='your-username'
export UPS_PASSWORD='your-password'
ups auth status

Authentication

  • API key, username, and password from UPS Developer Kit
  • Environment variables: UPS_API_KEY, UPS_USERNAME, UPS_PASSWORD

Package Tracking

Track Shipments
ups track TRACKING_NUMBER
ups track TRACKING_NUMBER --details
ups track TRACKING_NUMBER --proof-of-delivery
Batch Tracking
ups track --file tracking-numbers.txt
ups track 1Z999AA10123456784 1Z999AA10234567895 --summary
History
ups history --days 30 --status delivered
ups recent --limit 20

Shipping Rates

ups rates --from "90210" --to "10001" --weight 5lbs
ups rates --from ZIP --to ZIP --weight WEIGHT --dimensions LxWxH --service ground
ups rates compare --from ZIP --to ZIP --weight 10lbs

Shipping Labels

ups label create --from SHIPPER_JSON --to RECIPIENT_JSON --package PACKAGE_JSON
ups label void LABEL_ID --confirm
ups label reprint LABEL_ID

Pickup & Drop-off

ups pickup schedule --date 2024-06-15 --time "14:00-16:00"
ups pickup cancel PICKUP_ID
ups locations --near "90210" --type "UPS Store"

Agent Best Practices

  1. Tracking numbers: Validate format before querying
  2. Rate shopping: Use compare for best service/price
  3. Address validation: Use --validate before creating labels
  4. Reference numbers: Use for internal tracking

Comments

Markdown supported