findmy

Automate FindMy on macOS via AppleScript and screen capture to locate Apple devices and AirTags.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

FindMy has no command-line interface or public API, which makes locating Apple devices and AirTags on macOS cumbersome. This skill provides automated FindMy workflows using AppleScript and screen capture to read locations.

Core Features & Use Cases

  • AppleScript automation to launch FindMy and navigate the UI.
  • Screen capture to read device locations, with optional Peekaboo-based UI automation for reliability.
  • Workflow to track AirTag locations over time and periodically capture updates.

Quick Start

Open FindMy and run the workflow to locate a device or AirTag.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I automate finding Apple devices and AirTags on macOS without a CLI?

Automating FindMy on macOS is achieved through AppleScript UI navigation and screen capture to read device locations. This approach bypasses the lack of an official CLI or API by interacting directly with the FindMy interface.

Can I track AirTag movement over time using FindMy on macOS?

Yes, tracking AirTag locations over time is possible by periodically running an AppleScript workflow that captures screen updates. This allows you to monitor movement and verify locations when the FindMy UI is the only available interface.

Do I need Peekaboo to automate locating Apple devices on macOS?

Peekaboo is optional for automating FindMy, providing enhanced reliability for UI automation. The core functionality relies on AppleScript and screen capture, but Peekaboo helps ensure consistent location reading.

What macOS permissions are required to read AirTag locations via AppleScript?

Reading AirTag locations via AppleScript requires macOS permissions for automation and screen recording. You must be signed into the FindMy app to allow the script to navigate the UI and capture location data.

Why does my FindMy AppleScript automation fail to read device locations?

FindMy AppleScript automation may fail if screen recording permissions are missing or FindMy is not signed in. Ensuring macOS grants the necessary accessibility and screen capture permissions to your automation tool resolves location reading issues.

What is the best way to verify an AirTag location programmatically on macOS?

The best way to verify an AirTag location programmatically is using AppleScript to launch FindMy and screen capture to read the UI. Since no official API exists, this method extracts location data directly from the interface.