findmy

Track Apple devices and AirTags via FindMy UI automation on macOS.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/dawsonblock/HERMY --skill findmy-dawsonblock
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/dawsonblock/HERMY/tree/main/hermes-agent-2026.4.23/skills/apple/findmy
Command: npx skills add https://github.com/dawsonblock/HERMY --skill findmy-dawsonblock

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track Apple devices and AirTags using the FindMy app on macOS via automation since there is no official CLI for FindMy.

Core Features & Use Cases

  • AppleScript + Screenshot method to open FindMy, navigate, and read locations.
  • Peekaboo UI Automation (optional) for more reliable UI interaction and detail capture.
  • Workflow support for monitoring AirTag locations and device presence over time with periodic checks.
  • Limitations: FindMy provides no CLI or API; location updates require the UI to be visible and permissions granted.
  • Use Case: IT admins tracing devices, or users tracking their own items across macOS.

Quick Start

Open FindMy, enable automation with AppleScript or Peekaboo, and start capturing and analyzing device locations.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate AirTag location tracking on macOS without a CLI?

Automate AirTag tracking on macOS by using AppleScript to open the Find My app, navigate the UI, and capture screen locations. This method bypasses the lack of an official CLI by reading device coordinates directly from the interface.

Can I use Peekaboo for Find My UI automation to monitor device locations?

Yes, Peekaboo can be used optionally for Find My UI automation to achieve more reliable interaction and detail capture when monitoring Apple devices. It supplements AppleScript by handling complex UI elements during location checks.

Do I need screen recording permissions to track Apple devices with AppleScript?

Yes, screen recording permissions are required to track Apple devices with AppleScript on macOS. The automation relies on screen capture to read location data from the Find My app, meaning the UI must be visible during monitoring.

What are the limitations of monitoring AirTag locations via macOS UI automation?

The main limitations of monitoring AirTag locations via macOS UI automation are that Find My provides no API, location updates require the UI to be visible, and screen recording permissions must be granted for the automation to function.

How does periodic device presence monitoring work with the Find My app?

Periodic device presence monitoring works by running AppleScript workflows that repeatedly open Find My, capture the current screen state, and analyze the locations of iPhones, iPads, Macs, or AirTags over scheduled intervals.