findmy

Automate macOS FindMy app to track Apple devices and AirTags.

3|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/DarkArty07/Aether-Agents --skill findmy-darkarty07
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/DarkArty07/Aether-Agents/tree/main/home/skills/apple/findmy
Command: npx skills add https://github.com/DarkArty07/Aether-Agents --skill findmy-darkarty07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple provides no official CLI or API for the FindMy app on macOS, making it time-consuming to manually check the location of registered Apple devices, AirTags, or items attached to AirTags without navigating the graphical interface.

Core Features & Use Cases

  • Dual UI Automation Methods: Supports basic AppleScript combined with screenshot capture, and advanced Peekaboo UI automation for more reliable interaction with the FindMy app.
  • Multi-Device Tracking: Locate iPhones, iPads, Macs, AirPods, and AirTag-equipped items such as keys, bags, or pet collars.
  • Ongoing Movement Monitoring: Set up periodic location captures to track movement over time, such as a pet's daily patrol routes.

Quick Start

Use the findmy skill to check the current location of your registered AirTag attached to your cat.

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 via macOS without an API?

To track AirTag location without an API, this Skill uses UI automation of the macOS FindMy app to capture screenshots and extract location data via vision analysis. Apple lacks an official CLI or public API for FindMy, making UI automation necessary.

Can I automate FindMy device tracking on macOS using AppleScript?

Yes, you can automate FindMy device tracking using basic AppleScript combined with screenshot capture. For enhanced UI reliability during automation, installing Peekaboo provides advanced interaction capabilities with the FindMy app.

Do I need specific macOS permissions to enable FindMy location tracking?

Yes, enabling FindMy location tracking requires macOS with the FindMy app installed and Screen Recording permissions granted. These permissions allow the automation tool to capture the app interface and extract visual location data.

How do I monitor an AirTag's movement over time on a Mac?

You monitor an AirTag movement over time by setting up periodic location captures within the macOS FindMy app. This ongoing movement monitoring tracks routes, such as pet patrol paths, by capturing screenshots at intervals for vision analysis.

What are the limitations of using UI automation for FindMy device tracking?

Limitations of using UI automation for FindMy device tracking include reliance on visual interface stability and Screen Recording permissions. Without optional Peekaboo installation, basic AppleScript screenshot capture may be less reliable during interface changes.