LaunchKit · 2026
Back to Skills

findmy-location

Track a shared contact's location via Apple Find.

5
2.5k downloads
by @poiley

Setup & Installation

openclaw skills install @poiley/findmy-location

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install findmy-location

Version History

v1.1.1Jan 27, 2026 - Version note by skill developer:

Add skill description

What This Skill Does

Reads a shared contact's location from Apple Find My and returns a structured result with street address, city, and a context label (home, work, or out). It works by opening the Find My app, capturing the map, and matching visible landmarks against a user-defined list of known locations. A vision fallback flag is set when the location is unrecognized.

It exposes Find My location data as structured CLI output, making it scriptable for automations that the Find My app itself cannot trigger.

When to use it

  • Checking whether a family member has arrived home
  • Knowing when a partner leaves the office
  • Building location-aware automations triggered by a contact's position
  • Logging a contact's location from a script or cron job
  • Getting a quick terminal readout of someone's location without opening Find My

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: "Where is John right now?"

AGENT
  1. 1Opens the Find My app and selects John from the shared contacts list
  2. 2Captures a screenshot of the map and reads accessibility data
  3. 3Matches visible map landmarks against configured known locations
  4. 4Assigns a context label based on matched location markers
  5. 5Returns the address, city, state, and context as structured output
OUTPUT

456 Office Blvd, City, ST (work) - Now

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

iCloud account signed into macOS with Find My enabledLocation sharing enabled by the tracked contact in Apple Find Mypeekaboo screen-reading CLI (non-standard brew tap: steipete/tap/peekaboo, requires Accessibility and Screen Recording permissions)Hammerspoon (optional, for reliable UI clicking across windows)