A powerful automation toolkit for controlling native macOS applications including Mail, Calendar, Reminders, and Notes via AI-driven commands.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macos-suite
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install macos-suite using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is macOS Suite?
The macOS Suite is a comprehensive integration for Openclaw Skills designed to bridge the gap between AI agents and the local Apple ecosystem. It provides a secure and extensible framework to interact with system applications like Mail, Calendar, Reminders, Notes, Maps, and Freeform using a combination of AppleScript, UI Automation (System Events), URL Schemes, and the macOS open command.
This skill is engineered with a security-first approach, requiring explicit user confirmation for any data-modifying actions such as sending emails or creating calendar events. It transforms your local Mac environment into a programmable workspace where an AI agent can read your schedule, organize your notes, and even programmatically design boards in Freeform.
macOS Suite Use Cases
- Summarizing unread messages and drafting responses in Apple Mail.
- Managing daily schedules by adding or listing events in Apple Calendar.
- Programmatically generating project boards with shapes and text in Apple Freeform.
- Retrieving stock market data and weather updates for automated daily briefings.
- Searching for locations and getting directions directly through Apple Maps.
How macOS Suite Works
- The AI agent or user executes a Python script with a specific command and key-value parameters.
- The skill performs a permission check to ensure the host application has the necessary Accessibility and Automation rights.
- Depending on the target app, the skill selects the best protocol: AppleScript for structured data, UI Automation for visual layout, or macOS Shortcuts for stable fallbacks.
- For read operations, the skill extracts the requested data and returns a clean JSON object for the agent to process.
- For write operations, the skill verifies the presence of a confirmation flag; if absent, it returns a request for user approval before taking action.
macOS Suite Setup
To get started with this component of your Openclaw Skills library, ensure you are running macOS (Darwin) with Python 3 installed.
# Navigate to your skill directory
cd macos-suite
# Test the installation by opening a system app
python3 scripts/main.py open app="Calendar"
# Example: List unread emails
python3 scripts/main.py mail.unread_list limit=5
Note: You must grant Accessibility and Automation permissions to your terminal or host app in System Settings > Privacy & Security.
macOS Suite Data Schema & Taxonomy
The macOS Suite processes data through standardized JSON structures to ensure compatibility with various AI agents.
| Feature | JSON Keys | Description |
|---|---|---|
to, subject, body, attachments |
Fields for drafting and sending emails. | |
| Reminders | title, notes, due, list |
Structure for task management. |
| Calendar | start, end, location, title |
Event scheduling parameters. |
| Freeform | boardTitle, items, type, kind |
Schema for UI-based board composition. |
| Stocks | symbol, price, history |
Financial data structure. |
macOS Suite Advanced Features
- Shortcuts Fallback: Automatically utilizes macOS Shortcuts to bypass AppleScript limitations in Reminders and Weather apps.
- UI Automation: Leverages System Events to perform complex visual tasks in Freeform, such as adding shapes and sticky notes.
- Safety Gating: Implements a mandatory confirmation mechanism for all destructive or outgoing communication tasks.
- Sparkline Generation: Supports fetching historical stock data to create ASCII-based visual trends within local notes or boards.
SKILL.md
Loading
Related Openclaw Skills
macOS Suite Read-only
A read-only utility to fetch Mail, Calendar, Notes, and Stocks data from macOS in structured JSON format for AI agents.
Agent Evolver
An autonomous self-evolution engine that enables AI agents to learn from execution history, extract insights, and optimize their own strategies.
Sync Trending
An intelligent tech-monitoring agent that finds trending repositories and autonomously verifies them within your project's context.
WorkIQ for Microsoft 365
A natural language CLI tool for querying emails, meetings, documents, and Teams messages within the Microsoft 365 ecosystem.
SiliconFlow Image Generation
A high-performance image generation skill for AI agents leveraging the SiliconFlow API for FLUX and Stable Diffusion models.
SiliconFlow TTS Generation
A high-performance text-to-speech skill leveraging the SiliconFlow API and CosyVoice2 model for realistic voice synthesis.
Featured*
