findmy

Locate Apple devices and AirTags on macOS via FindMy.app UI automation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locate Apple devices and AirTags using FindMy.app on macOS when a CLI or API is unavailable, enabling automated location discovery through UI automation.

Core Features & Use Cases

  • Read device and AirTag locations by launching FindMy and capturing UI data using AppleScript and screen capture.
  • Optional: leverage Peekaboo for more reliable UI automation and annotation of results.
  • Use cases include monitoring a device's or AirTag's position over time and quickly obtaining visible location details.

Quick Start

Open FindMy, enable Screen Recording permission, and run the AppleScript automation to capture the current locations of your devices.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate Apple device location tracking on macOS when no CLI or API is available?

Automate Apple device location tracking on macOS by using AppleScript and screen capture to launch FindMy.app, read the visible UI, and extract current location data for your iCloud devices.

How do I read AirTag location data on macOS using UI automation?

Read AirTag location data on macOS by launching FindMy.app and capturing the on-screen interface with AppleScript, allowing you to monitor AirTag movement and obtain visible location details programmatically.

Do I need Screen Recording permission to automate FindMy.app on macOS?

Yes, Screen Recording permission is required to automate FindMy.app on macOS. You must enable this access for your automation environment so AppleScript can reliably capture the on-screen location data.

Can I use Peekaboo for more reliable FindMy UI automation?

Yes, you can use Peekaboo for more reliable FindMy UI automation. Leveraging Peekaboo enhances the AppleScript screen capture process and helps annotate the extracted device and AirTag location results.

What is the best way to monitor Apple device positions over time without an API?

The best way to monitor Apple device positions over time without an API is running AppleScript UI automation to repeatedly capture FindMy.app screens, enabling you to track device and AirTag movement at set intervals.

Why does my AppleScript FindMy automation fail to capture locations?

AppleScript FindMy automation fails to capture locations when Screen Recording permission is missing or iCloud is not signed in. Ensure FindMy is open and macOS privacy settings explicitly allow screen capture.