icloud-findmy
por liamnichols
Apple Apps & ServicesResumo
Query Find My locations and battery status for family devices.
Descrição
O que esta skill faz
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.
Quando usá-la
- 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
Exemplo de fluxo de trabalho
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.
Requisitos
- Apple ID (iCloud account)
- iCloud Family Sharing enabled to access family devices
Instalação
clawhub install liamnichols/icloud-findmyExecute o comando da CLI ou cole o prompt no Claude Code, Cursor, Codex ou no agente de código que você usa.