A local-first CLI tool for managing multiple email providers through the native Apple Mail app on macOS without requiring external APIs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install apple-mail-macos
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 apple-mail-macos 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 Apple Mail (MacOS)?
The Apple Mail (MacOS) skill provides a powerful command-line interface for interacting with any email account synced to your Mac, including Gmail, Outlook, iCloud, Yahoo, and Fastmail. By leveraging native system tools like AppleScript and Shortcuts, this skill allows users to read, search, and triage messages without the complexity of managing individual provider APIs or OAuth tokens. As a key component of the Openclaw Skills ecosystem, it prioritizes a local-first architecture where your data remains on your machine, using the Mail.app as a unified account layer for all operations.
Apple Mail (MacOS) Use Cases
- Triage and archive emails across multiple accounts using quick CLI commands.
- Search through local mail archives and read message bodies directly within your terminal.
- Automate the drafting and sending of emails while maintaining manual safety gates.
- Perform bulk move or delete operations with deterministic dry-run previews.
- Integrate email workflows into larger developer automation scripts using Openclaw Skills.
How Apple Mail (MacOS) Works
- The skill detects available command paths by probing for osascript, macOS Shortcuts, or sqlite3 for read-only indexed lookups.
- It maps the local mailbox structure to identify accounts already connected to the Apple Mail application.
- For any requested write action, the skill generates a dry-run summary showing impacted messages and recipients.
- Upon user confirmation, it executes the command using the most reliable local automation path available.
- Every operation is assigned a unique ID and logged to ensure idempotency and prevent duplicate actions like double-sending.
- A final read-back verification is performed to confirm the mailbox state matches the intended outcome.
Apple Mail (MacOS) Setup
To get started with this skill in the Openclaw Skills environment, ensure you have at least one mail account configured in the macOS Mail app.
# Initial setup to define provider scope and safety defaults
# Follow the instructions provided in the setup file
cat ~/apple-mail-macos/setup.md
You must grant your terminal or IDE permission to control Mail.app under System Settings > Privacy & Security > Automation.
Apple Mail (MacOS) Data Schema & Taxonomy
The skill maintains its operational state and logs within the ~/apple-mail-macos/ directory to ensure transparency and reliability.
| File | Purpose |
|---|---|
memory.md |
Stores provider maps, current status, and safety defaults. |
command-paths.md |
Tracks functional automation paths and fallback preferences. |
safety-log.md |
A historical record of all send and delete confirmations. |
operation-log.md |
Contains unique Operation IDs and verification evidence for every task. |
Apple Mail (MacOS) Advanced Features
- Multi-path automation probing that switches between AppleScript and macOS Shortcuts for maximum compatibility.
- High-risk confirmation gates for actions involving external recipients or bulk data changes.
- Idempotency protection using unique Operation IDs to prevent accidental repeat executions.
- Provider-aware operations that account for specific folder naming conventions in Gmail, Outlook, and iCloud.
- Deep integration with other Openclaw Skills like macos and productivity for end-to-end task automation.
SKILL.md
Loading
Related Openclaw Skills
Apple Health
A privacy-safe skill for Openclaw Skills that enables AI agents to analyze Apple Health exports using MCP and DuckDB.
Apple Calendar (MacOS)
A local-first tool for managing all macOS-synced calendars through a unified CLI interface without requiring external API keys.
Mobile App Growth Agent
A specialized skill for launching and scaling mobile applications through data-driven ASO, monetization optimization, and viral growth loops.
App Store Management
A professional toolkit for managing the full lifecycle of iOS and Android app submissions, from account setup to rejection handling.
Apple Maps (MacOS)
A specialized macOS automation skill for searching locations and managing navigation routes through native CLI commands and secure confirmation gates.
Apple News (MacOS)
A deterministic macOS integration for automating Apple News article access, reading queues, and topic searches through CLI and Shortcuts.
Featured*
