findmy

Automate Find My on macOS to locate Apple devices and AirTags.

14|2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/gquthier/CLAWG --skill findmy-gquthier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/gquthier/CLAWG/tree/main/skills/apple/findmy
Command: npx skills add https://github.com/gquthier/CLAWG --skill findmy-gquthier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

FindMy has no official CLI for programmatic location tracking. This skill automates locating Apple devices and AirTags on macOS by driving Find My via AppleScript and capturing screen content to read locations.

Core Features & Use Cases

  • AppleScript + Screenshot workflow to open Find My and extract device locations.
  • Optional Peekaboo UI automation for more reliable interactions.
  • Workflow support for tracking AirTag routes and monitoring device movement over time.
  • Awareness of limitations such as UI automation fragility and required permissions.

Quick Start

Open Find My on macOS, ensure you are signed in, then run the provided AppleScript workflow to locate devices and read their positions.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate Find My on macOS to locate Apple devices and AirTags?

Automate Find My on macOS by running an AppleScript workflow that opens the app, selects your Apple devices or AirTags, and captures screen content to read their current locations. This requires Find My access and screen recording permission.

Can I track AirTag location changes over time using macOS automation?

Yes, you can track AirTag routes and monitor device movement over time by running the AppleScript automation workflow repeatedly on macOS. The workflow captures screen content during each execution to reveal current AirTag positions for tracking purposes.

What macOS permissions are required to automate Apple device location tracking?

Automating Apple device location tracking requires macOS screen recording permission and Find My access. You must be signed into Find My on macOS, and the environment must support UI-based AppleScript automation to properly capture and read device locations.

Does Find My automation work with Peekaboo tooling for more reliable UI interactions?

Find My automation optionally uses Peekaboo tooling for more reliable UI interactions when locating Apple devices and AirTags on macOS. Peekaboo enhances the AppleScript and screenshot workflow by improving the stability of UI-based automation commands.

Why does my AppleScript Find My automation fail to capture device locations?

AppleScript Find My automation fails when screen recording permission is missing, Find My is not signed in, or macOS environment compatibility issues disrupt UI automation. The skill's UI-based approach is inherently fragile and requires a compatible macOS setup.

What is the best way to get programmatic location data for Apple devices without a CLI?

The best way to get programmatic location data without an official CLI is UI-based automation using AppleScript on macOS. This approach drives the Find My app directly and captures screen content to extract current locations for Apple devices and AirTags.