findmy

Automate Find My on macOS to read on-screen Apple device and AirTag locations.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/photonics-dhl/Hermes --skill findmy-photonics-dhl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/photonics-dhl/Hermes/tree/main/hermes-home/skills/apple/findmy
Command: npx skills add https://github.com/photonics-dhl/Hermes --skill findmy-photonics-dhl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the location scanning of Apple devices and AirTags by leveraging Find My on macOS, overcoming the absence of a CLI.

Core Features & Use Cases

  • AppleScript + Screenshot: Open Find My and read device locations from the UI.
  • Peekaboo integration (optional) for more reliable UI automation.
  • Time-based tracking: Periodically capture locations for patrol routes of AirTags or devices.

Quick Start

Open Find My, ensure Screen Recording permission is granted for Terminal, and run the automated workflow to read device locations.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track AirTag and Apple device locations from the macOS command line?

You can track Apple device and AirTag locations from the macOS command line by automating the Find My app using AppleScript and capturing on-screen location data through screenshots.

Can I automate Find My on macOS without using a graphical interface?

Automating Find My on macOS requires interacting with the graphical interface because Apple does not provide a CLI, so this Skill uses AppleScript and screenshot reading to extract device locations.

What macOS permissions are required to automate Find My location tracking?

macOS Find My location tracking automation requires Screen Recording permission to be granted for your Terminal application, allowing the Skill to read on-screen device locations.

Does Find My automation support periodic location tracking for AirTags?

Yes, Find My automation supports time-based tracking by periodically capturing locations, which is applicable for monitoring patrol routes of AirTags and Apple devices over time.

What is Peekaboo used for in macOS UI automation for Apple devices?

Peekaboo is an optional integration that provides more reliable UI automation when extracting Apple device and AirTag locations from the Find My interface on macOS.

Why does my Find My location automation not work on macOS?

Find My location automation on macOS fails if Screen Recording permission is not granted to Terminal, preventing the AppleScript and screenshot workflow from reading on-screen device data.