Skip to content
TakoAPI
Back to skills

icloud-findmy

by liamnichols

Apple Apps & Services
2.6kDownloads reported by clawskills.sh
6Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Query Find My locations and battery status for family devices.

Description

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

INPUT

User asks: Where is my wife's iPhone and what's the battery level?

AGENT
  1. 1

    Run icloud --username APPLE_ID --with-family --list to fetch all device data

  2. 2

    Parse output sections separated by dashes to find the matching device

  3. 3

    Extract Battery Level value and multiply by 100 for percentage

  4. 4

    Extract Location dict and parse latitude/longitude coordinates

  5. 5

    Format and return location and battery status to user

OUTPUT

Wife's iPhone is at 52.248, 0.761 with 72% battery, not charging.

Requirements

  • Apple ID (iCloud account)
  • iCloud Family Sharing enabled to access family devices

Installation

clawhub install liamnichols/icloud-findmy

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links