findmy

Automate Find My app launch and screen reading to identify device locations on macOS.

Updated Apr 19, 2026

Search Tags:#automation #macos #screencapture #apple-script #findmy #airtag

Ready to run

npx skills add https://github.com/gqf2008/hermez-ai --skill findmy-gqf2008

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/gqf2008/hermez-ai/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/gqf2008/hermez-ai --skill findmy-gqf2008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Locating Apple devices and AirTags can be clunky when there is no CLI for Find My; this Skill automates app control and screen capture to read and report locations.

Core Features & Use Cases

Automates opening Find My, selecting a device or AirTag, and reading the on-screen location
Allows switching between Devices and Items tabs to monitor multiple assets
Supports optional UI automation tooling to improve reliability

Quick Start

Open Find My and switch to the Devices or Items tab to read the current location of your target device.

Frequently Asked Questions about findmy

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

FAQPage Schema

How do I check AirTag location on macOS using automation?▼

AirTag location tracking on macOS works by using AppleScript to launch Find My, switch to the Items tab, and capture the screen to read current positions. Optional Peekaboo UI automation improves reliability.

Can I track multiple Apple devices on macOS without a CLI?▼

Tracking multiple Apple devices without a CLI is possible by automating the Find My app to switch between the Devices and Items tabs. The Skill reads the screen to report each device's current location.

Do I need screen recording permissions to use Find My automation on macOS?▼

Find My automation requires screen recording permissions to capture and read on-screen locations. You also need AppleScript automation enabled and access to the Find My app on macOS.

Does Find My automation work with Peekaboo UI automation?▼

Yes, Find My automation supports optional Peekaboo UI automation to improve reliability. It enhances the process of opening the app, selecting devices or AirTags, and reading the on-screen location.

What are the limitations of automating Find My on macOS?▼

Automating Find My on macOS is limited to user-owned devices only and requires AppleScript, screen recording permissions, and Find My access. It reads on-screen data rather than querying a dedicated API.