Agent skill
c-contacts
macOS Contacts — search, list, and look up contact details via AppleScript.
Install this agent skill to your Project
npx add-skill https://github.com/daxaur/openpaw/tree/main/skills/c-contacts
SKILL.md
Contacts — Address Book
Access macOS Contacts app via AppleScript. No CLI tool needed.
Commands
# Search for a contact by name
osascript -e 'tell application "Contacts"
set results to (every person whose name contains "John")
set output to ""
repeat with p in results
set output to output & name of p & linefeed
repeat with e in emails of p
set output to output & " Email: " & value of e & linefeed
end repeat
repeat with ph in phones of p
set output to output & " Phone: " & value of ph & linefeed
end repeat
set output to output & linefeed
end repeat
return output
end tell'
# Get all contact names
osascript -e 'tell application "Contacts" to get name of every person'
# Get a specific contact's email
osascript -e 'tell application "Contacts"
set p to first person whose name is "John Smith"
get value of every email of p
end tell'
# Get a specific contact's phone
osascript -e 'tell application "Contacts"
set p to first person whose name is "John Smith"
get value of every phone of p
end tell'
# Count contacts
osascript -e 'tell application "Contacts" to count every person'
# Search by email
osascript -e 'tell application "Contacts"
set results to (every person whose value of emails contains "john@")
get name of results
end tell'
Guidelines
- Always search by partial name (uses
contains) to be flexible - Return name, email, and phone by default
- If multiple matches, list all and let the user pick
- Contacts app does not need to be running — AppleScript handles it
- Never store contact details in memory files for privacy
- If asked "what's [name]'s number?", search contacts first, then memory
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
c-slack
Send messages and upload files to Slack channels using the `slack` CLI. Supports direct messages, channel posts, file uploads, and thread replies.
c-timer
Timers, alarms, and pomodoro — set countdowns with native notifications.
c-telegram
Bidirectional Telegram bridge — talk to Claude from your phone. Built into OpenPaw.
c-system
macOS Swiss Army Knife — control volume, wifi, battery, dock, display, trash, firewall, screensaver, shutdown, and more via m-cli.
c-tracking
Track packages across UPS, FedEx, USPS, and DHL using the `ordercli` CLI. Look up tracking numbers, get current status, estimated delivery dates, and shipment history without visiting carrier websites.
c-network
DNS lookups with doggo and readable HTTP requests with httpie — modern networking tools for the terminal.
Didn't find tool you were looking for?