A CLI-based integration for retrieving real-time Apple Find My device locations, battery status, and hardware telemetry.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install findmy-icloud-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install findmy-icloud-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Find My iCloud CLI?
The Find My iCloud CLI skill provides a robust and programmable interface for accessing Apple Find My services. By leveraging the pyicloud library, this skill allows users to query the location and status of their own Apple devices as well as family-shared hardware without relying on flaky UI automation. It is a foundational component for users building localized automation within the ecosystem of Openclaw Skills.
This skill prioritizes reliability and security by utilizing a deterministic state file to manage Apple ID usernames rather than hardcoding sensitive information. It effectively bridges the gap between natural language requests and the technical iCloud API, making it easy to integrate device tracking into broader developer workflows.
Find My iCloud CLI Use Cases
- Locating a specific person by resolving their name to their most likely active device (e.g., iPhone or Apple Watch).
- Monitoring the battery levels and charging status of all family-shared Apple devices.
- Automating alerts or scripts based on the geographic coordinates of a Mac or iPad.
- Identifying the exact hardware model and display name of devices registered to an iCloud account.
How Find My iCloud CLI Works
- The skill initializes by checking a local state file for the user's Apple ID username.
- Users perform a one-time authentication via the pyicloud flow, which handles passwords and 2FA.
- The skill executes shell scripts that wrap the iCloud CLI to fetch device data in a structured JSON format.
- Specialized Python scripts perform fuzzy matching to find specific devices or resolve person-based aliases.
- The system filters results based on device priority, such as preferring an iPhone's location over an Apple Watch's location.
Find My iCloud CLI Setup
To get started with this entry in the Openclaw Skills library, follow these steps:
# Navigate to the skill directory
cd ~/.openclaw/workspace/skills/findmy-icloud-cli
# Set your Apple ID (do this once)
./scripts/findmy.sh set-username [email protected]
# Authenticate with iCloud
./scripts/findmy.sh auth-login
Find My iCloud CLI Data Schema & Taxonomy
The skill manages state and output using the following structures:
| Data Type | Path / Format | Description |
|---|---|---|
| Account State | ~/.local/state/icloud-findmy-cli/account.env |
Stores the ICLOUD_FINDMY_USERNAME environment variable. |
| Aliases | ~/.local/state/icloud-findmy-cli/people-aliases.json |
Maps nicknames like 'partner' or 'kid' to real names. |
| Device JSON | { "name": "...", "battery_level": 0.8, "location": {...} } |
Standardized output schema for device telemetry. |
Find My iCloud CLI Advanced Features
- Intelligent device resolution that automatically picks the best device (iPhone > Watch) for location queries.
- Fuzzy name matching for identifying devices without needing exact hardware strings.
- Support for family-sharing visibility, allowing tracking of all devices within an Apple Family group.
- Deterministic local state management to ensure consistency across different Openclaw Skills sessions.
SKILL.md
Loading
Related Openclaw Skills
Lottery Helper
A comprehensive lottery data management and recommendation engine that automates result queries, data exports, and strategy backtesting.
Tokyo-JP Brand Profile
A professional research skill designed to provide deep-dive intelligence and historical archives for the Tokyo-JP brand.
Singapore-City Intelligence Skill
A comprehensive data retrieval skill providing structured insights into the Singapore-City brand and its market presence.
SearXNG Search Skill
A privacy-focused meta-search integration that aggregates real-time web results from over 70 engines for AI agents.
paris-fr Brand Intelligence
A comprehensive intelligence skill for analyzing the paris-fr brand's history, products, and market influence.
Learned from AI
A specialized skill designed to distill transient AI conversations into permanent, structured technical notes and cheat sheets for long-term human study.
Featured*
