apple-contacts

What This Skill Does

The apple-contacts skill enables your OpenClaw agent to interface directly with the native macOS Contacts application. By leveraging AppleScript, the agent can programmatically search, retrieve, and filter your personal contact information. This skill bridges the gap between your local address book and your AI agent, allowing it to perform tasks like phone number verification, email address lookup, and contact detail reconciliation without manual intervention.

Installation

To integrate this skill, run the following command in your OpenClaw terminal: clawhub install openclaw/skills/skills/tyler6204/apple-contacts Ensure you have granted OpenClaw the necessary macOS permissions to access your Contacts when prompted during the first execution.

Use Cases

• Efficient Communication: Automatically identify callers or resolve contact names from raw phone numbers found in your call logs.
• Administrative Tasks: Batch verify contact details or sync information between different communication platforms.
• Contextual Intelligence: Provide the agent with context regarding who you are talking about, allowing it to reference stored emails or alternative phone numbers during a conversation.
• Data Management: Quickly retrieve and export contact information based on partial name searches or specific identifier matches.

Example Prompts

1. "Check my contacts and tell me if there is an email address listed for John Doe."
2. "I have a missed call from +15550102030. Can you look up who this belongs to in my address book?"
3. "List all contact information, including emails and secondary numbers, for Sarah Smith."

Tips & Limitations

When using the apple-contacts skill, keep the following in mind to ensure optimal performance:

• Phone Format Sensitivity: The skill performs an exact string match for phone numbers. If a search for a 10-digit number returns nothing, try including the international country code (e.g., +1).
• Name Search Flexibility: Name searches are case-insensitive and support partial matches using the 'contains' logic. Use 'is' if you require an exact match.
• Handling Results: The skill returns data as a comma-separated list of names, phones, and emails. If no entry is found, the agent will report a null or empty response rather than an error. When dealing with multiple matches, the agent is configured to prioritize the first found record to maintain performance, so always verify the output if your contact list contains duplicate names.