mac-automation — Claude Code skill: what it does, how to install
The mac-automation skill uses AppleScript to control macOS apps and system functions. Ask it to handle mail, create reminders, or perform Finder tasks.
no license 1 installs ★ 1 updated 2025-12-15
npx skills add 7Sageer/cc-assistant --skill mac-automation -a claude-codeWhat mac-automation does
The skill runs AppleScript through osascript to interact with Mail, Reminders, Calendar, Safari, and Finder. It can also adjust volume, display notifications, and launch apps. AppleScript support for third-party software depends on the app; the skill suggests checking its dictionary in Script Editor or trying a basic request.
The package includes app-specific reference files, working script examples, and the scripts/run-applescript.sh wrapper. macOS may ask for automation permission the first time an app is controlled. Destructive actions such as deleting files require user confirmation, and some operations depend on the target app already running.
What it helps with
- create a reminder with a due date
- add an event to Calendar
- find or read unread messages
- open a folder or move a file in Finder
- change the volume or show a system notification
Example prompts for the agent
- Create a Reminders entry for my call tomorrow.
- Find unread messages in Mail and show me who sent them.
- Open the current page in Safari and run JavaScript on it.
How to install mac-automation
1Skills CLI (Vercel)
npx skills add 7Sageer/cc-assistant --skill mac-automation -a claude-code2Manually: put the files in place
~/.claude/skills/mac-automation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mac-automation/
1Skills CLI (Vercel)
npx skills add 7Sageer/cc-assistant --skill mac-automation -a codex2Manually: put the files in place
.agents/skills/mac-automation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 7Sageer/cc-assistant --skill mac-automation -a cursor2Manually: put the files in place
.cursor/skills/mac-automation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 7Sageer/cc-assistant .claude/skills/mac-automation2Manually: put the files in place
.github/skills/mac-automation/SKILL.md1Skills CLI (Vercel)
npx skills add 7Sageer/cc-assistant --skill mac-automation -a gemini-cli2Platform CLI
gemini skills install https://github.com/7Sageer/cc-assistant --path .claude/skills/mac-automationManually: put the files in place
.devin/skills/mac-automation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add 7Sageer/cc-assistant --skill mac-automation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mac-automation
How do I install mac-automation in Claude Code?
Run npx skills add 7Sageer/cc-assistant --skill mac-automation -a claude-code. The skill file is located at ~/.claude/skills/mac-automation/SKILL.md.
What does mac-automation do?
It uses AppleScript and osascript to control macOS apps and selected system functions, including mail, calendars, browsers, and files.
Why might an AppleScript action fail?
macOS can request permission before allowing an app to be controlled. Some actions also rely on the target app being installed and running.