Apple Contacts Skill

Overview

• Manages macOS Contacts.app through AppleScript.
• No external dependencies — uses only bash and osascript.
• Main helper script: scripts/contacts.sh.
• All commands return JSON for agent consumption.

Quick Start

# Search for a contact by name
bash ~/.agents/skills/apple-contacts/scripts/contacts.sh search --field name --limit 10 "John"

# Search for a contact by email
bash ~/.agents/skills/apple-contacts/scripts/contacts.sh search --field email --exact "john@example.com"

# Get full details of a contact
bash ~/.agents/skills/apple-contacts/scripts/contacts.sh get "John Doe"