🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Apple Contacts

by @neriros

Access and search Apple Contacts on macOS using AppleScript. Use when the user asks to look up a contact, find a phone number or email, search contacts by na...

Versionv1.0.1
Downloads772
TERMINAL
clawhub install macos-contacts

πŸ“– About This Skill


name: macos-contacts description: Access and search Apple Contacts on macOS using AppleScript. Use when the user asks to look up a contact, find a phone number or email, search contacts by name, or get details about someone in their address book. macOS only.

Apple Contacts (AppleScript)

Uses osascript to query the macOS Contacts app. macOS only. Requires Contacts permission on first run β€” macOS will show a prompt, click Allow.

Setup

No installation required. Just ensure the skill's scripts/ directory is intact after installing.

Usage

# List all contacts
osascript /scripts/contacts.applescript list

Search by name (case-insensitive)

osascript /scripts/contacts.applescript search "Alice"

Get full details for a contact

osascript /scripts/contacts.applescript get "Alice Smith"

Replace with the absolute path to this skill's directory (use pwd inside the skill folder if unsure).

Output format

  • list / search: one line per match β†’ Name | Phone | Email
  • get: full details (all phones, emails, birthday, notes), contacts separated by ---
  • Notes

  • First run may trigger a macOS Contacts permission dialog β€” user must click Allow
  • If no contacts found, returns a descriptive message instead of empty output
  • Script supports partial name matching (e.g. "Ali" matches "Alice Smith")
  • πŸ’‘ Examples

    # List all contacts
    osascript /scripts/contacts.applescript list

    Search by name (case-insensitive)

    osascript /scripts/contacts.applescript search "Alice"

    Get full details for a contact

    osascript /scripts/contacts.applescript get "Alice Smith"

    Replace with the absolute path to this skill's directory (use pwd inside the skill folder if unsure).

    βš™οΈ Configuration

    No installation required. Just ensure the skill's scripts/ directory is intact after installing.

    πŸ“‹ Tips & Best Practices

  • First run may trigger a macOS Contacts permission dialog β€” user must click Allow
  • If no contacts found, returns a descriptive message instead of empty output
  • Script supports partial name matching (e.g. "Ali" matches "Alice Smith")