Manage macOS Contacts.app — search, view, create, edit, and delete contacts. Use when the user asks to find a contact, look up a phone number or email, add a new contact, update contact details, or list contact groups.
Use this skill when the task is about Apple Contacts.app on macOS.
scripts/commandsscripts/applescripts/contact{"success": ...} envelope~/.agents/skills/macos-contactsskills check and skills update may refer to the upstream package name apple-contacts from vinitu/apple-contacts-skillUse only scripts/commands.
Do not call scripts/applescripts/contact directly.
Do not use scripts/contacts.sh in skill instructions; it is kept only as a compatibility wrapper.
bashosascriptscripts/commands/contact/search.shscripts/commands/contact/get.shscripts/commands/contact/list.shscripts/commands/contact/add.shscripts/commands/contact/edit.shscripts/commands/contact/delete.shscripts/commands/group/list.shscripts/commands/system/doctor.shadd.sh keeps the old verb add to preserve compatibility with older callers.
{"success": false, "error": "..."} and exit with status 1.{"success": true, ...}.--json, --plain, and --format=plain|json are not supported.bash ~/.agents/skills/macos-contacts/scripts/commands/contact/search.sh --field name --limit 10 "John"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/search.sh --field email --exact "[email protected]"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/get.sh "John Doe"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/get.sh --id "23B708DC-4556-41E3-8738-89867826B760:ABPerson"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/list.sh --limit 20
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/list.sh --group "Work"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/add.sh --first "John" --last "Doe" --phone "+48123456789" --email "[email protected]" --org "Acme" --birthday "04-20"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/add.sh --first "John" --last "Doe" --birthday "1988-04-20"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/edit.sh "John Doe" --phone "+48111222333"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/edit.sh --id "23B708DC-4556-41E3-8738-89867826B760:ABPerson" --email "[email protected]"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/edit.sh "John Doe" --birthday "04-20"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/edit.sh --id "23B708DC-4556-41E3-8738-89867826B760:ABPerson" --birthday "1988-04-20"
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/edit.sh --id "23B708DC-4556-41E3-8738-89867826B760:ABPerson" --clear-birthday
bash ~/.agents/skills/macos-contacts/scripts/commands/contact/delete.sh --id "23B708DC-4556-41E3-8738-89867826B760:ABPerson"
bash ~/.agents/skills/macos-contacts/scripts/commands/group/list.sh
bash ~/.agents/skills/macos-contacts/scripts/commands/system/doctor.sh
Success envelope:
success: truecount, data, id, name, or messageFailure envelope:
success: falseerror: stringContact object:
idnamephonesemailsaddressesorganizationjob_titlebirthdaynoteSearch and list rules:
search.sh supports --field name|phone|email|org|all, --limit N, and --exactadd.sh and edit.sh support --birthday in MM-DD or YYYY-MM-DD formatedit.sh supports --clear-birthday to remove an existing birthday--field phone or --field email for exact lookups by number or emailmobile, home, work, and other1604 when the year is not setadd.sh, edit.sh, and delete.sh.