Automates macOS apps via Apple Events using AppleScript (discovery) and JXA (production logic). Use when asked about AppleScript, JXA, osascript, or macOS app automation.
No commands yet. Add command files here when ready.
Create or update a contact, optionally assign to groups
Convert a CSV into a formatted Excel workbook
Convert a CSV into a formatted Numbers workbook
Turn a Pages or Word document into a compelling slide deck
No agents yet. Add agent files here when ready.
Creates or updates a contact and assigns groups
Imports CSV into Excel and applies formatting
Imports CSV into Numbers and applies formatting
Converts a Pages or Word document into a Keynote slide deck
Automates macOS Calendar via JXA with AppleScript dictionary discovery. Use when asked to "create calendar events", "automate calendar", "JXA calendar scripting", "EventKit automation", or "PyXA calendar automation". Covers events, calendars, recurrence, time zones, batch operations, and EventKit ObjC bridge.
Automates Google Chrome and Chromium-based browsers via JXA with AppleScript dictionary discovery. Use when asked to "automate Chrome tabs", "control browser with JXA", "Chrome AppleScript automation", "Chromium browser scripting", or "browser tab management". Covers windows, tabs, execute(), tunneling patterns, and permissions.
Automates macOS Contacts via JXA with AppleScript dictionary discovery. Use when asked to "automate contacts", "JXA contacts automation", "macOS address book scripting", "AppleScript contacts", or "Contacts app automation". Covers querying, CRUD, multi-value fields, groups, images, and ObjC bridge fallbacks.
Automates Microsoft Excel on macOS via JXA with AppleScript dictionary discovery. Use when asked to "automate Excel spreadsheets", "JXA Excel scripting", "Excel macOS automation", or "bulk Excel data operations". Focuses on workbooks, worksheets, ranges, 2D arrays, performance toggles, and VBA escape hatches.
Automates Apple Keynote using JXA with AppleScript dictionary discovery. Use when asked to "create Keynote presentations", "automate slide decks", "JXA Keynote scripting", or "generate presentations programmatically". Covers document lifecycle, slides, text, shapes, images, tables, charts, transitions, and UI scripting fallback.
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Automates macOS apps via Apple Events using AppleScript (discovery), JXA (legacy), and PyXA/Python (preferred). Includes skills for Calendar, Notes, Mail, Keynote, Numbers, Excel, Reminders, Contacts, and more.
Note: This is a plugin for Claude Code. It is not ready for prime time yet. Only use it if you are a developer and want to help test it. I have tested it with Reminders, Keynote, Numbers, Notes, Contactc, Calendar, Messenger (send only), and Mail. It is useful as-is but please report any issues or suggestions. Tested Pages and it did not go well. We could only add basic text. We could paste in images but could not predict where they would end up in the doc. Everything else is woefully short on testing.

Connect your favorite Mac applications to Claude Code through Apple Events automation. Control Calendar, Notes, Mail, Keynote, Numbers, and more with natural language commands.

The plugin uses a three-layer architecture:

Comprehensive coverage across productivity, communication, and development apps:

How automation flows from your request to app control:
/plugin marketplace add SpillwaveSolutions/automating-mac-apps-plugin
Once the plugin is available as a Claude Code marketplace:
claude plugins install automating-mac-apps-plugin
Clone directly into your Claude skills directory:
# Navigate to Claude skills directory
cd ~/.claude/skills
# Clone the repository
git clone https://github.com/SpillwaveSolutions/automating-mac-apps-plugin.git
# Or clone to a specific location and symlink
git clone https://github.com/SpillwaveSolutions/automating-mac-apps-plugin.git ~/projects/automating-mac-apps-plugin
ln -s ~/projects/automating-mac-apps-plugin ~/.claude/skills/automating-mac-apps-plugin
plugins/automating-mac-apps-plugin/ folder to ~/.claude/skills/cp -r plugins/automating-mac-apps-plugin ~/.claude/skills/
After installation, verify the plugin is recognized:
# List installed plugins
claude plugins list
# Or check the skills directory
ls ~/.claude/skills/
Before using the automation skills, you need to grant macOS Automation permissions. Run the setup scripts to trigger permission prompts:
cd ~/.claude/skills/automating-mac-apps-plugin
./skills/automating-mac-apps/scripts/request_automation_permissions.sh
# Or use Python:
python3 ./skills/automating-mac-apps/scripts/request_automation_permissions.py
Run individual setup scripts as needed:
| App | Script |
|---|---|
| Calendar | ./skills/automating-calendar/scripts/set_up_calendar_automation.sh |
| Notes | ./skills/automating-notes/scripts/set_up_notes_automation.sh |
./skills/automating-mail/scripts/set_up_mail_automation.sh | |
| Keynote | ./skills/automating-keynote/scripts/set_up_keynote_automation.sh |
| Numbers | ./skills/automating-numbers/scripts/set_up_numbers_automation.sh |
| Excel | ./skills/automating-excel/scripts/set_up_excel_automation.sh |
| Reminders | ./skills/automating-reminders/scripts/set_up_reminders_automation.sh |
| Contacts | ./skills/automating-contacts/scripts/set_up_contacts_automation.sh |
| Voice Memos | ./skills/automating-voice-memos/scripts/set_up_voice_memos_automation.sh |
npx claudepluginhub SpillwaveSolutions/automating-mac-apps-plugin --plugin automating-mac-appsDocument search with hybrid BM25/semantic retrieval, GraphRAG knowledge graphs, and pluggable providers for Claude Code. Index documentation and code, then search using keyword matching, semantic similarity, graph relationships, or comprehensive multi-mode fusion.
Build, test, and debug AWS-native systems locally with LocalStack (Community/Pro) using awslocal, IaC toolchains, event-driven pipelines, and observability; includes setup, deployment, management, monitoring, and sharp-edge guidance.
Debugging-first guidance for professional Docker development across CLI, Compose, Docker Desktop, and Rancher Desktop
Wizard-style codebase explainer and documentation generator. Accepts any codebase, spec, or markdown artifact and explains it through conversational Q&A — with code-block anchors, plain-English explanations, and follow-up predictions. Two modes: Describe (repo owner documents their codebase) and Explore (new developer gets a learning-order tour). Sessions auto-captured and synthesizable as CODEBASE.md or TOUR.md.
Generate validated design documentation for any codebase. Walks a repo bottom-up and emits a docs/design/ tree: per-class docs, package rollups, mermaid diagrams (syntax + semantic validated), tech-debt ledger, system design, and unresolved HIL disputes YAML.
Control macOS GUI applications via mouse, keyboard, screenshots, image recognition, and AppleScript using the sagui CLI.
Apple-native MCP server with production governance built in — HMAC-chained audit log, per-call HITL, OAuth 2.1 + Resource Indicators, scope gate, rate limit, emergency stop file. 272 tools across 29 modules: Calendar, Notes, Mail, Reminders, Contacts, Messages, Music, Finder, Safari, Photos, Maps, Podcasts, Weather, iWork, Google Workspace, Apple Intelligence, UI Automation, Shortcuts, Context Memory. Native Swift bridges into EventKit, HealthKit, PhotoKit, Vision, Foundation Models. macOS local-first, multi-client (Claude, Codex, opencode, Gemini CLI, Antigravity, Cursor, Zed, Cline, ChatGPT MCP Apps).
Scaffold and enhance production-ready macOS apps with XcodeGen, GitHub Actions CI/CD, code signing, notarization, auto-update, and SwiftUI starter code
Build, validate, sign, and archive macOS/iOS Shortcuts directly from Claude Code. Ships a full Shortcuts knowledge base, a Craig Loop validator, a build agent, and a PostToolUse hook that auto-validates every .xml/.shortcut file as it is written.
macOS integration - speak, send iMessages, emails, manage calendar, and display stickies
Claude Code skill pack for Apple Notes (24 skills)