← Back to Skills Marketplace
292
Downloads
0
Stars
3
Active Installs
2
Versions
Install in OpenClaw
/install macos-contacts
Description
Access and search Apple Contacts on macOS using AppleScript. Use when the user asks to look up a contact, find a phone number or email, search contacts by na...
README (SKILL.md)
Apple Contacts (AppleScript)
Uses osascript to query the macOS Contacts app. macOS only. Requires Contacts permission on first run — macOS will show a prompt, click Allow.
Setup
No installation required. Just ensure the skill's scripts/ directory is intact after installing.
Usage
# List all contacts
osascript \x3Cskill_dir>/scripts/contacts.applescript list
# Search by name (case-insensitive)
osascript \x3Cskill_dir>/scripts/contacts.applescript search "Alice"
# Get full details for a contact
osascript \x3Cskill_dir>/scripts/contacts.applescript get "Alice Smith"
Replace \x3Cskill_dir> with the absolute path to this skill's directory (use pwd inside the skill folder if unsure).
Output format
list/search: one line per match →Name | Phone | Emailget: full details (all phones, emails, birthday, notes), contacts separated by---
Notes
- First run may trigger a macOS Contacts permission dialog — user must click Allow
- If no contacts found, returns a descriptive message instead of empty output
- Script supports partial name matching (e.g. "Ali" matches "Alice Smith")
Usage Guidance
This skill's purpose (reading Apple Contacts via osascript) is plausible, but the package as published contains only SKILL.md and no scripts. Before installing: (1) do not install or enable the skill unless the package includes the referenced scripts/contacts.applescript files — ask the publisher for the missing files or a verified release. (2) If you obtain the scripts, inspect their contents before running to ensure they only access local Contacts and do not transmit data elsewhere. (3) Be aware enabling the skill will trigger macOS Contacts permission and allow the script to read your address book (sensitive personal data). (4) Prefer installing/testing in a controlled macOS account or sandboxed environment and confirm no network calls are made by the scripts. If the publisher cannot supply the missing scripts or a trustworthy source, treat the skill as incomplete/untrusted.
Capability Analysis
Type: OpenClaw Skill
Name: macos-contacts
Version: 1.0.1
The skill is a macOS-specific utility designed to search and retrieve information from the Apple Contacts app using AppleScript. While it accesses sensitive personal data (including contact notes), its behavior is transparently documented and strictly aligned with its stated purpose in SKILL.md, with no evidence of malicious intent, data exfiltration, or obfuscation in the provided files.
Capability Assessment
Purpose & Capability
The stated purpose (querying macOS Contacts via AppleScript) is coherent with using osascript, but the SKILL.md requires a scripts/contacts.applescript under the skill directory. The package manifest contains only SKILL.md and no scripts or code files, so the skill as published cannot perform the claimed functionality without additional files not present in the package.
Instruction Scope
Instructions are narrowly scoped to running osascript against a local AppleScript to read Contacts. That behavior legitimately requires macOS Contacts permission and will access sensitive personal data (all address-book entries). The instructions do not ask to read unrelated files or exfiltrate data, but they do direct the agent to access local contacts — a privacy-sensitive action that should be explicit to users.
Install Mechanism
There is no install spec (instruction-only), which is low-risk in general. However the SKILL.md's 'ensure scripts/ directory is intact' requirement is inconsistent with the manifest's lack of any scripts. Either required script files were omitted from the package or SKILL.md is stale; both are problematic because the skill will fail or depend on out-of-band downloads.
Credentials
No environment variables, credentials, or config paths are requested — appropriate for a local Contacts lookup. Note that the skill will request macOS Contacts permission at runtime, which grants access to the user's address book (sensitive personal data).
Persistence & Privilege
always is false and autonomous invocation is allowed (platform default). There is no evidence the skill requests permanent presence or modifies other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install macos-contacts - After installation, invoke the skill by name or use
/macos-contacts - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fix: removed hardcoded user path
v1.0.0
Initial release: search and look up Apple Contacts via AppleScript
Metadata
Frequently Asked Questions
What is Apple Contacts?
Access and search Apple Contacts on macOS using AppleScript. Use when the user asks to look up a contact, find a phone number or email, search contacts by na... It is an AI Agent Skill for Claude Code / OpenClaw, with 292 downloads so far.
How do I install Apple Contacts?
Run "/install macos-contacts" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Apple Contacts free?
Yes, Apple Contacts is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Apple Contacts support?
Apple Contacts is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Apple Contacts?
It is built and maintained by NeriRos (@neriros); the current version is v1.0.1.
More Skills