Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add 7Sageer/cc-assistant --skill mac-automation -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/mac-automation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mac-automation/

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.

Similar skills

All skills for Automation and no-code: n8n, Zapier, Make →

Project sponsors

Companies that keep this analytics open