mac-automation
Automate macOS Apps with AppleScript
Manual macOS tasks can be slow when they span Mail, Calendar, Finder, Safari, and system settings. This skill gives Claude, Codex, and Claude Code structured AppleScript patterns for local automation.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "mac-automation". Create a reminder from my clipboard for tomorrow morning.
Expected outcome:
The assistant checks clipboard content, creates a Reminders item for tomorrow at 9:00, and confirms the reminder title.
Using "mac-automation". Show my unread email count and today's meetings.
Expected outcome:
- Unread mail count with recent sender and subject details.
- Today's calendar events with times and titles.
- A note if permissions are missing.
Using "mac-automation". Open GitHub in Safari and get the current page title.
Expected outcome:
Safari opens the requested page, returns the active tab title, and reports any permission or window errors.
Security Audit
Medium RiskStatic analysis correctly identified extensive external command usage, but this is the declared purpose of the skill: guiding osascript and AppleScript automation. I found no evidence of prompt injection, hidden network exfiltration, malware staging, or confirmed malicious intent. The skill should publish with a warning because it can read private local data, manipulate files, send mail, run shell commands through AppleScript, and perform disruptive system actions.
Medium Risk Issues (5)
Low Risk Issues (3)
Risk Factors
⚙️ External commands (3)
🌐 Network access (4)
📁 Filesystem access (3)
Detected Patterns
Quality Score
What You Can Build
Personal productivity shortcuts
Create reminders, calendar events, notifications, and clipboard-based notes without switching between several apps.
Office workflow automation
Draft or send Mail messages, review unread mail summaries, and organize files with repeatable local automation.
Browser and file task scripting
Open Safari pages, inspect tab information, run controlled JavaScript, and manage Finder files during support workflows.
Try These Prompts
Use the mac-automation skill to create a reminder for [task] due [date and time]. Show me the AppleScript before running it.
Use AppleScript to get today's Calendar events and unread Mail subjects. Only show the sender, subject, and event title.
Prepare a Finder automation plan to move [file type] files from [source folder] to [target folder]. Ask before moving anything.
Use Safari AppleScript to open [site], collect the current page title and selected text, then propose the next automation step before acting.
Best Practices
- Ask for confirmation before sending mail, deleting data, changing files, or triggering power actions.
- Show the planned AppleScript for sensitive actions before execution.
- Limit output to the fields the user requested when reading private app data.
Avoid
- Do not run generated AppleScript that includes unreviewed shell commands or user-provided paths.
- Do not read Mail, clipboard, browser content, or calendar data without explicit user request.
- Do not empty Trash, delete app data, send email, or shut down the Mac as part of a broad request.