findmy

Automate Apple device and AirTag location tracking via FindMy on macOS.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/shiftrepo/aws --skill findmy-shiftrepo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/shiftrepo/aws/tree/main/HermesAgent/skills/skills/apple/findmy
Command: npx skills add https://github.com/shiftrepo/aws --skill findmy-shiftrepo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading device locations tracked by Apple's FindMy app on macOS is not accessible via a CLI or API, making automated monitoring and integration challenging.

Core Features & Use Cases

  • AppleScript-based automation to launch Find My and capture screen content for location extraction.
  • Optional UI automation with Peekaboo for more reliable interactions with the app's UI to read device data.
  • Workflow: periodically read and log locations for devices or AirTags to build simple patrol routes or activity history.
  • Limitations: relies on screen capture and UI automation; location updates require the app window to be visible and permissions granted.
  • Example: track a tagged asset over time and compile coordinates into a local log.

Quick Start

Open FindMy and start tracking a device by reading its on-screen location at regular intervals.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate reading Find My app locations on macOS?

Automating Find My tracking on macOS uses AppleScript to launch the app and screen capture to extract location data. This method works around the lack of a direct CLI or API for reading Apple device coordinates.

Can I log AirTag coordinates periodically using AppleScript?

Logging AirTag coordinates periodically uses AppleScript to read on-screen locations at set intervals. This builds a simple activity history or patrol route for tracked items and pets.

Does Find My automation require the app window to be visible?

Find My automation requires the app window to be visible because it relies on screen capture and UI automation to read locations. You must also grant the necessary screen recording permissions.

What is Peekaboo used for in macOS Find My automation?

Peekaboo is an optional tool providing more reliable UI automation for interacting with the Find My app. It helps script the interface to read device data more consistently than screen capture alone.

Why does my Find My screen capture script fail to get location updates?

Find My screen capture scripts fail to get location updates if the app window is not visible or if macOS screen recording permissions are not granted. The automation strictly depends on reading visible on-screen content.

What is the best way to track a tagged asset over time on macOS?

The best way to track a tagged asset over time on macOS uses scripted AppleScript to periodically read and log Find My locations. This compiles coordinates into a local log for activity history.