findmy

Automate the FindMy app on macOS to locate Apple devices and AirTags.

1|Updated Apr 30, 2025
One-click install
npx skills add https://github.com/lucasfth/config --skill findmy-lucasfth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/lucasfth/config/tree/main/.hermes/skills/apple/findmy
Command: npx skills add https://github.com/lucasfth/config --skill findmy-lucasfth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This solution enables you to locate Apple devices and AirTags by automating the FindMy app on macOS when a CLI is unavailable. It leverages AppleScript to launch FindMy and uses screen capture to read device locations, offering a workaround for visual UI data retrieval.

Core Features & Use Cases

  • AppleScript + Screenshot: Open FindMy, switch to the appropriate tab, and capture device locations.
  • Peekaboo-based UI Automation (Optional): If installed, provides more reliable interactions for reading device information.
  • AirTag location monitoring: Periodically capture and check locations to trace movement history while the page is open.

Quick Start

Open FindMy, ensure screen recording is enabled, and run the provided AppleScript to view 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 location on macOS when there is no command line API?

You can track AirTag location on macOS by automating the FindMy app with AppleScript. This Skill launches the app, switches to the correct tab, and captures screen visuals to read device coordinates without needing a dedicated CLI.

Can I use AppleScript to get current positions for iPhone and iPad?

Yes, AppleScript can retrieve current positions for iPhone and iPad by automating the FindMy app. It periodically captures screenshots to verify device locations visually when direct data access is unavailable.

What do I need to set up before automating FindMy for location tracking?

You need macOS with the FindMy app installed and screen recording permissions enabled for screenshot capture. Optional Peekaboo tooling can also be installed to provide more reliable UI automation interactions.

How does screen capture and vision analysis work for reading FindMy device locations?

Screen capture and vision analysis read FindMy device locations by taking screenshots of the app interface. The captured images are then processed with OCR or vision tools to extract map coordinates and device status visually.

Is there a way to trace AirTag movement history while the FindMy page is open?

Yes, you can trace AirTag movement history by periodically capturing and checking locations. The Skill performs repeated screenshot captures while the FindMy page remains open to monitor and record route changes over time.