Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Complete rewrite: Pure documentation skill, no code dependencies. Agent uses icloud CLI directly.
What This Skill Does
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.
When to use it
- 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
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Where is my wife's iPhone and what's the battery level?
- 1Run `icloud --username APPLE_ID --with-family --list` to fetch all device data
- 2Parse output sections separated by dashes to find the matching device
- 3Extract Battery Level value and multiply by 100 for percentage
- 4Extract Location dict and parse latitude/longitude coordinates
- 5Format and return location and battery status to user
Wife's iPhone is at 52.248, 0.761 with 72% battery, not charging.
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.