Agent skill · software engineering · sundial-org
icloud-findmy
Query Find My locations and battery status for family devices via iCloud.
Why this skill is useful
Adds specific commands and patterns for querying Find My device locations and battery status that the AI wouldn't reliably generate on its own.
What it needs
Requires pipx installed locally. Requires icloud account access. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
iCloud Find My Access Find My device locations and battery status via the iCloud CLI (pyicloud). Setup 1. Install pyicloud: 2. Authenticate (one-time): Ask the user for their Apple ID, then run: They'll need to enter their password and complete 2FA. The session will be saved and lasts 1-2 months. 3. Store Apple ID: Add the Apple ID to your TOOLS.md or workspace config so you remember it for future queries: Usage List all devices Output format: Parsing tips: Devices are separated by ------------------------------ Location is a Python dict (use eval() or parse with regex) Battery Level is 0.0-1.0 (multiply by 100 for percentage) Battery Status: "Charging" or "NotCharging" Location fields: latitude, longitude, timeStamp (milliseconds), horizontalAccuracy Get specific device Find a specific device by grepping the output: Parse location Extract and format location data: Then parse the Python dict string with Python or extract coordinates with regex. Parse battery Device Names Device names come from iCloud and may include: Fancy Unicode apostrophes (U+2019 ') instead of ASCII ' No apostrophes at all (e.g., "Lindas iPhone") Use case-insensitive matching and normalize apostrophes if needed. Session Management Sessions last 1-2 months Stored in user's home directory When expired, re-run the authentication step PyiCloud validates automatically on each request Common Patterns Check battery before going out: Get current location: Check if device is charging: Proactive Use Cases Battery warnings: Check battery levels before calendar events (going out) Location context: Answer "near me" queries by checking user's current location Home/away detection: Check if user is at home based on coordinates Low battery alerts: Warn if battery <30% and not charging Troubleshooting Authentication errors: Session expired - re-authenticate Wrong Apple ID - check stored ID 2FA required - complete 2FA flow No location available: Device offline Find My disabled Location Services off Device not foun …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/icloud-findmy