findmy

Automate Find My on macOS to reveal Apple device and AirTag locations.

Updated May 1, 2026
One-click install
npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill findmy-xiaoquqi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/xiaoquqi/hermes-agent-skills/tree/main/apple/findmy
Command: npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill findmy-xiaoquqi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Track Apple devices and AirTags via FindMy.app on macOS when no CLI or API exists, enabling automated location checks through AppleScript and screen capture.

Core Features & Use Cases

  • AppleScript automation: Open Find My and navigate to devices or items.
  • Screen capture + reading: Capture the UI and read locations using vision analysis.
  • Optional UI automation helper: Leverage Peekaboo for more reliable interactions.
  • Use Case: Monitor AirTag patrol routes or locate a device over time.

Quick Start

Run FindMy automation to read current locations of your registered devices.

Frequently Asked Questions about findmy

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

FAQPage Schema
How do I track Apple devices and AirTags on macOS when there is no CLI or API?

You can automate location tracking for Apple devices and AirTags on macOS by using AppleScript UI automation and screen capture to read data from the Find My app. This method enables automated location checks when no official CLI or API exists.

What permissions do I need to automate Find My on macOS?

Automating Find My on macOS requires screen recording permission to capture the UI and AppleScript access for UI automation. You also need to be signed into the Find My app with your Apple ID to locate registered devices.

Can I monitor AirTag movement over time using macOS UI automation?

Yes, you can monitor AirTag patrol routes or locate a device over time by automating the Find My app. The process captures the UI repeatedly to read current locations, which is useful when GPS data isn't accessible via a CLI.

How does screen capture read Apple device locations from the Find My app?

Screen capture reads Apple device locations by taking screenshots of the Find My app interface and applying vision analysis to extract the text. This allows the automation to identify and reveal the current locations of your registered items.

Are there tools to improve UI automation reliability for Find My on macOS?

Yes, you can leverage an optional UI automation helper like Peekaboo to ensure more reliable interactions when navigating the Find My app. This helps stabilize the screen capture and reading process during automated location checks.