findmy

Track Apple devices and AirTags via macOS Find My UI automation.

Updated Jun 25, 2026
One-click install
npx skills add https://github.com/davpatel605-beep/hermusagent --skill findmy-davpatel605-beep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: findmy
Source: https://github.com/davpatel605-beep/hermusagent/tree/main/backend/vendor/hermes/skills/apple/findmy
Command: npx skills add https://github.com/davpatel605-beep/hermusagent --skill findmy-davpatel605-beep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users locate their Apple devices and AirTags when they need location information but Apple does not provide a direct command-line interface for Find My tracking.

Core Features & Use Cases

  • Find My Location Access: Opens the macOS Find My app and captures location information for registered Apple devices and AirTags.
  • UI-Based Tracking Workflow: Uses AppleScript, screenshots, and optional Peekaboo automation to navigate Find My and read device locations.
  • Use Case: Track an owned AirTag attached to personal items or check the location of an iPhone, iPad, Mac, or AirPods through the Find My application.

Quick Start

Use the findmy skill to open Find My and determine the current location of my registered AirTag.

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 from the command line on macOS?

You can track AirTags by using this Skill to automate the macOS Find My app via AppleScript. It opens the application, navigates the UI, and captures visible location details for registered devices and items. AppleScript control and screen capture permissions are required for reliable interaction.

Can I retrieve iPhone or Mac location details without a direct Find My API?

Yes, you can retrieve iPhone or Mac location details without a direct Find My API by using UI automation. This Skill applies AppleScript and optional Peekaboo automation to read device locations directly from the macOS Find My application interface.

What macOS permissions are required to automate Find My device tracking?

Automating Find My device tracking requires macOS Find My access, AppleScript control, and screen capture permissions. Optional Peekaboo automation is also recommended to ensure reliable UI interaction when extracting location details.

What is the best way to extract Apple device location data through UI automation?

The best way to extract Apple device location data through UI automation is using AppleScript to control the Find My app. This Skill captures screenshots and navigates the interface to read location information for registered hardware and AirTags.

Why does my AppleScript Find My tracking workflow fail to capture location details?

AppleScript Find My tracking workflows may fail if macOS screen capture permissions or AppleScript control are missing. Utilizing optional Peekaboo automation can improve reliability when navigating the Find My UI to extract location data.