icloud-findmy
par liamnichols
Apple Apps & ServicesRésumé
Query Find My locations and battery status for family devices.
Description
Ce que fait ce skill
Queries Apple iCloud Find My to retrieve device locations and battery status for personal and family devices. Uses pyicloud CLI under the hood. Requires one-time 2FA authentication, after which sessions persist for 1-2 months.
Gives programmatic access to Find My data without manual app interaction, enabling automated battery checks and location queries from any agent workflow.
Quand l'utiliser
- Check iPhone battery before leaving home
- Find where a family member's device is located
- Confirm if a device is charging or not
- Detect whether user is home or away based on coordinates
- Get current coordinates to answer location-aware questions
Exemple de workflow
User asks: Where is my wife's iPhone and what's the battery level?
- 1
Run
icloud --username APPLE_ID --with-family --listto fetch all device data - 2
Parse output sections separated by dashes to find the matching device
- 3
Extract Battery Level value and multiply by 100 for percentage
- 4
Extract Location dict and parse latitude/longitude coordinates
- 5
Format and return location and battery status to user
Wife's iPhone is at 52.248, 0.761 with 72% battery, not charging.
Prérequis
- Apple ID (iCloud account)
- iCloud Family Sharing enabled to access family devices
Installation
clawhub install liamnichols/icloud-findmyExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.