← Back to Skills Marketplace
macOS Contacts
by
Leocdchina
· GitHub ↗
· v0.1.1
· MIT-0
94
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install openclaw-macos-contacts
Description
Read, search, and safely create contacts in macOS Contacts (Address Book). Use when the user asks to inspect the native macOS contacts database, search conta...
Usage Guidance
This skill appears coherent and implements local read/write workflows for macOS Contacts. Before installing or running it: (1) review and be comfortable with backups written to ~/.openclaw/state/macos-contacts (these contain contact data and should be protected or cleaned if needed); (2) expect to grant macOS Contacts automation/Contacts.framework permission when running Swift/AppleScript writes; (3) inspect any commands you run under contacts_txn.sh since it executes arbitrary local commands and will restore backups on failure; (4) confirm you have swift/python installed on the target mac; and (5) note there are some minor code quality issues (e.g., a bug in a Merge script's 'originals' construction and a truncated Swift file in the distribution preview) — consider testing in a safe environment or reviewing those files before using in production.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-macos-contacts
Version: 0.1.1
The skill provides extensive access to the macOS Contacts database and includes a transaction wrapper (`contacts_txn.sh`) for shell command execution. While no malicious intent is evident, the scripts exhibit several high-risk patterns and vulnerabilities, specifically unsafe string interpolation of shell variables into Python heredocs in `scripts/contacts_txn.sh` and `scripts/contacts_dedupe.sh`, which could lead to code injection if command outputs contain unexpected characters. Additionally, the skill's core functionality requires broad permissions to read and modify sensitive user data in `~/Library/Application Support/AddressBook/`, which is a significant attack surface.
Capability Assessment
Purpose & Capability
Name/description match the included artifacts: SQLite-based read script, Swift/AppleScript write paths, backup/restore and transaction wrappers, and dedupe/merge helpers. The requested capabilities (none: no env vars or external credentials) align with a local-contacts skill.
Instruction Scope
Runtime instructions explicitly target the local macOS Contacts DB and Contacts APIs. Scripts read ~/Library/Application Support/AddressBook/AddressBook-v22.abcddb (sqlite read uses mode=ro) and use osascript/Contacts.framework for writes. This is expected, but note backups and transaction wrappers write files under $HOME/.openclaw/state/macos-contacts (sensitive contact data will be present there). The txn wrapper executes the supplied mutating command and will restore backups on failure — normal for transactional safety but gives the skill the ability to run local mutating commands that you should review before invoking.
Install Mechanism
Instruction-only skill with no installer. Bundled scripts are plain Python, Bash, Swift and AppleScript wrappers that run locally — no external downloads or install steps were included.
Credentials
No environment variables, credentials, or network endpoints are requested. The skill stores runtime backups under ~/.openclaw/state/macos-contacts which is proportional for a backup/txn workflow but could be a privacy consideration since contact data is persisted there.
Persistence & Privilege
always:false and user-invocable:true (default) — normal. The skill does not modify other skills or system-wide agent settings. It creates local backup state under the user's home (expected for rollback functionality).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-macos-contacts - After installation, invoke the skill by name or use
/openclaw-macos-contacts - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
Add Chinese documentation and publishing metadata cleanup
v0.1.0
Initial private release: SQLite read + Swift Contacts.framework write/check + backup/rollback + dedupe/merge
Metadata
Frequently Asked Questions
What is macOS Contacts?
Read, search, and safely create contacts in macOS Contacts (Address Book). Use when the user asks to inspect the native macOS contacts database, search conta... It is an AI Agent Skill for Claude Code / OpenClaw, with 94 downloads so far.
How do I install macOS Contacts?
Run "/install openclaw-macos-contacts" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is macOS Contacts free?
Yes, macOS Contacts is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does macOS Contacts support?
macOS Contacts is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created macOS Contacts?
It is built and maintained by Leocdchina (@leocdchina); the current version is v0.1.1.
More Skills