Skip to content
TakoAPI
Back to skills

findmy-location

by poiley

Apple Apps & Services
2.5kDownloads reported by clawskills.sh
5Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Track a shared contact's location via Apple Find.

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

INPUT

User asks: "Where is John right now?"

AGENT
  1. 1

    Opens the Find My app and selects John from the shared contacts list

  2. 2

    Captures a screenshot of the map and reads accessibility data

  3. 3

    Matches visible map landmarks against configured known locations

  4. 4

    Assigns a context label based on matched location markers

  5. 5

    Returns the address, city, state, and context as structured output

OUTPUT

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

Requirements

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

Installation

clawhub install poiley/findmy-location

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links