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

## Install

```bash
npx skillstore add 7sageer, claude/7sageer-mac-automation
```

## Metadata

- - Slug: 7sageer-mac-automation
- - Version: 0.0.5
- - Author: 7Sageer, Claude
- - GitHub username: 7Sageer
- - License: MIT
- - Repository: https://github.com/7Sageer/cc-assistant/tree/main/.claude/skills/mac-automation
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: medium
- - Risk factors: external\_commands, network, filesystem
- - Quality score: 50
- - Quality tier: warning
- - Public page: https://skillstore.pages.dev/skills/7sageer-mac-automation
- - Manifest: https://skillstore.pages.dev/api/skills/7sageer-mac-automation/manifest

## Capabilities

- Create, read, search, and delete Mail messages using AppleScript examples.
- Create and manage Reminders and Calendar events with due dates and details.
- Open Safari URLs, inspect page details, manage tabs, and run page JavaScript.
- Move, copy, rename, delete, and reveal files through Finder automation patterns.
- Control local macOS functions such as notifications, volume, clipboard, apps, screenshots, and power actions.
- Provide troubleshooting guidance for macOS Automation and Accessibility permissions.

## Use Cases

- 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.

## Prompt Templates

### Create a reminder

```
Use the mac-automation skill to create a reminder for [task] due [date and time]. Show me the AppleScript before running it.
```

### Summarize today

```
Use AppleScript to get today's Calendar events and unread Mail subjects. Only show the sender, subject, and event title.
```

### Organize files

```
Prepare a Finder automation plan to move [file type] files from [source folder] to [target folder]. Ask before moving anything.
```

### Automate Safari workflow

```
Use Safari AppleScript to open [site], collect the current page title and selected text, then propose the next automation step before acting.
```

## Limitations

- Requires macOS with AppleScript support and local permission prompts approved by the user.
- Examples may need app names, paths, calendars, or lists changed for each system.
- Some Safari JavaScript actions require the Safari developer setting for JavaScript from Apple Events.
- Destructive commands can cause data loss if used without confirmation.

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

## Anti Patterns

- 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.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-27T17:19:56.212\+00:00
- - Summary: Static 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.

## Stats

- - Views: 149
- - Downloads: 8
- - Favorites: 0
- - Popularity score: 0
