# mac-automation

The mac-automation skill uses AppleScript to control macOS apps and system functions. Ask it to handle mail, create reminders, or perform Finder tasks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 install · ★ 1 repo stars
- Author: 7Sageer, Claude
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/7Sageer/cc-assistant/tree/HEAD/.claude/skills/mac-automation/SKILL.md
- Updated: 2025-12-15
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mac-automation

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 7Sageer/cc-assistant --skill mac-automation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mac-automation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mac-automation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 7Sageer/cc-assistant --skill mac-automation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mac-automation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 7Sageer/cc-assistant --skill mac-automation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mac-automation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 7Sageer/cc-assistant .claude/skills/mac-automation
```

2. **Manually: put the files in place**
- File: `.github/skills/mac-automation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 7Sageer/cc-assistant --skill mac-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/7Sageer/cc-assistant --path .claude/skills/mac-automation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mac-automation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add 7Sageer/cc-assistant --skill mac-automation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/7Sageer/cc-assistant/tree/HEAD/.claude/skills/mac-automation/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [mac-maintenance](https://affpapa.org/en/nevibecode/skills/mac-maintenance.md) — skill · 117 installs
- [mcp-osascript](https://affpapa.org/en/nevibecode/mcp/mcp-osascript.md) — MCP server · ★ 12 repo stars
- [claude-for-safari](https://affpapa.org/en/nevibecode/skills/claude-for-safari.md) — skill · 1800 installs
- [capture-screen](https://affpapa.org/en/nevibecode/skills/capture-screen.md) — skill · 1100 installs
- [apple-mail](https://affpapa.org/en/nevibecode/skills/apple-mail.md) — skill · 1400 installs
- [applescript](https://affpapa.org/en/nevibecode/skills/applescript.md) — skill · 315 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
