findmy

Track Apple device and AirTag locations on macOS via UI automation.

1|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/automatedigital/spark --skill findmy-automatedigital
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/automatedigital/spark/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/automatedigital/spark --skill findmy-automatedigital

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple offers no official CLI or public API for the FindMy app, forcing users to manually navigate the graphical interface to check the location of their Apple devices or AirTags, which is inefficient for frequent checks or long-term tracking.

Core Features & Use Cases

  • Device and AirTag location lookup: Retrieve real-time location data for iPhones, iPads, Macs, AirPods, and AirTags registered to your Apple ID.
  • Long-term movement tracking: Capture periodic location updates to monitor the movement of tagged items or pets over hours or days.
  • Flexible automation support: Use basic built-in AppleScript and screen capture tools, or the optional peekaboo utility for more reliable UI interaction.
  • Real-world use case: Track your cat's daily patrol route by capturing AirTag location data every 30 minutes and compiling the full path.

Quick Start

Use the findmy skill to track the location of your AirTag-tagged backpack for the next 3 hours and compile a log of all location updates.

Frequently Asked Questions about findmy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track AirTag location on macOS without an official FindMy API?

You can track AirTag location on macOS using AppleScript UI automation and screen capture to interact with the FindMy app interface, retrieving real-time location data visually since no official API exists.

Can I automate retrieving Apple device locations from the FindMy app?

Yes, you can automate retrieving Apple device locations by leveraging AppleScript UI automation to interact with the FindMy app and extract location data via visual analysis of screen captures.

What's the best way to log AirTag movement over time on macOS?

The best way to log AirTag movement is by capturing periodic location updates using AppleScript, allowing you to monitor tagged items or pets over hours or days and compile the full path.

Does FindMy location tracking via AppleScript require any external dependencies?

FindMy location tracking via AppleScript requires no external dependencies, using built-in macOS screen capture tools, though the optional peekaboo utility can provide more reliable UI interaction.

What are the limitations of using UI automation for FindMy location data?

The limitation of using UI automation for FindMy location data is that it relies on visual analysis of screen captures rather than direct API access, requiring the FindMy app interface to be actively navigated.