A specialized CLI tool for reading, creating, and managing macOS Contacts via the native CNContactStore API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mac-contacts
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mac-contacts using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Mac Contacts Manager?
This skill provides a robust command-line interface to interact with the macOS unified contact store. By leveraging Openclaw Skills, developers and AI agents can perform deep searches across names, organizations, emails, and physical addresses, as well as manage contact group memberships. It bridges the gap between terminal-based workflows and the native Apple Contacts ecosystem.
The tool is designed to work with unified contact views, merging iCloud, local, and Exchange data into a single, searchable interface. All write operations are handled atomically, ensuring data integrity within the macOS environment while providing a developer-friendly YAML output for read operations.
Mac Contacts Manager Use Cases
- Automated contact lookup for AI agents during scheduling or communication tasks.
- Bulk creation of professional contacts from lead lists or incoming emails.
- Programmatic organization of contacts into specific groups such as Work or Clients.
- Searching for contacts by specific geographic criteria like city or country for marketing or logistics.
How Mac Contacts Manager Works
- The skill interfaces with the macOS CNContactStore to access unified contact views across all accounts (iCloud, local, and Exchange).
- Users or agents execute subcommands like search or create via the CLI, which processes inputs using Python and pyobjc.
- Read operations emit structured YAML data for easy parsing by scripts or other Openclaw Skills.
- Write operations utilize CNSaveRequest for atomic updates to the local or cloud contact database.
- Specific group removals are handled via osascript to bypass known limitations in the native framework for iCloud-backed groups.
Mac Contacts Manager Setup
To use this skill within Openclaw Skills, you must first install the required Python dependencies on your macOS machine:
pip install pyobjc-framework-Contacts pyyaml
You must also grant Contacts access to your Terminal or agent host via System Settings → Privacy & Security → Contacts when prompted.
Mac Contacts Manager Data Schema & Taxonomy
The skill outputs data primarily in YAML format for high readability and easy automation.
| Component | Format | Description |
|---|---|---|
| Search Output | YAML List | Contains name, organisation, phone(s), email(s), and address(es). |
| Contact Detail | YAML Mapping | Detailed view including job titles, URLs, social profiles, and list memberships. |
| Group List | YAML List | A simple list of all defined contact groups/lists. |
| Status Messages | Plain Text | Prefixed with Success: or Error: for status tracking. |
Mac Contacts Manager Advanced Features
- Atomic write operations using CNSaveRequest to prevent data corruption during multi-field updates.
- Normalized fuzzy phone matching that allows searching by digits regardless of formatting.
- AppleScript integration to ensure reliable group membership removal for iCloud-synced accounts.
- Support for partial name matching and multi-pass searches across organization and address fields.
SKILL.md
Loading
Related Openclaw Skills
LinkedIn Post Engine
A strategic content creation tool that transforms raw ideas into high-performing, persuasive LinkedIn posts using proven narrative frameworks.
Ralph OpenCode Free Loop
An autonomous coding agent loop that leverages Ralph CLI and OpenCode Zen free models with built-in fallback logic.
De-AI-ify (Humanize AI Text)
A sophisticated skill for transforming rigid, robotic AI-generated content into authentic, conversational, and human-sounding prose.
Email Summary Skill
Quickly fetch and condense your latest Gmail messages into actionable AI-generated summaries within your agent workflow.
Unified Skill Finder
A comprehensive search and installation tool for discovering agent capabilities across multiple major skill registries.
Naruto Multi-Agent Dispatcher
A Naruto-themed multi-agent system that ranks and dispatches missions to specialized sub-agents for efficient task execution.
Featured*
