Apple Mail (MacOS)
Use local CLI to manage Gmail, Outlook, iCloud, Yahoo, Fastmail, and other mail accounts synced in Apple Mail on macOS, without APIs or OAuth.
Why use this skill?
Control your macOS Mail app via CLI. Manage emails, automate workflows, and handle triage across Gmail, Outlook, and iCloud with local safety checks.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/ivangdavila/apple-mail-macosWhat This Skill Does
The Apple Mail (MacOS) skill provides a unified interface to control your local Mail.app instance via the CLI. It bridges the gap between complex email management tasks and the native macOS Mail environment, enabling automation of read, search, triage, draft, send, move, archive, and delete workflows. By leveraging local automation tools like osascript, shortcuts, and sqlite3, this skill operates on top of your existing, configured mail accounts (Gmail, Outlook, iCloud, Yahoo, Fastmail, etc.) without requiring individual OAuth credentials or secondary API integrations.
Installation
To integrate this skill into your environment, run the following command: clawhub install openclaw/skills/skills/ivangdavila/apple-mail-macos. After installation, navigate to ~/apple-mail-macos/ to review the setup.md file. You must define your preferred command paths and safety defaults before attempting any write-heavy operations. The skill relies on local environment readiness, so ensure that your Mail.app has the necessary permissions for terminal automation in System Settings.
Use Cases
This skill is designed for power users who want to automate email triage without leaving their terminal. Use it to:
- Bulk-archive newsletters or promotional emails based on search criteria.
- Draft and queue responses to client emails using pre-defined templates.
- Search and extract information from your inbox to feed into other local automation workflows.
- Perform routine cleanup of junk or specific folders without manual clicking.
Example Prompts
- "Find all unread emails from 'Finance' in the last 48 hours and create a summary for me to review."
- "Draft a reply to the most recent email from John Doe using the 'project-update' template, but do not send it yet."
- "Move all messages with the subject 'Invoice' from the Inbox to the 'Accounting' folder."
Tips & Limitations
- Safety First: The skill enforces a strict dry-run pattern for all write actions. Always review the preview provided before confirming any execution.
- Read-Only Defaults: For complex indexing, the skill uses
sqlite3in read-only mode to prevent data corruption in the Mail database. - Unified Account Layer: This skill does not replace your email provider's sync; it simply acts as a remote control for the Mail.app application already syncing your data. If your Mail.app is closed or not syncing, the skill may not be able to process recent messages.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-ivangdavila-apple-mail-macos": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-write, file-read, code-execution
Related Skills
Amazon
Navigate Amazon as buyer, seller, or affiliate with price tracking, listing optimization, and smart purchasing decisions.
Analysis
Run deep system health checks across workspace, config, skills, and integrations with prioritized findings and remediation.
Arduino
Develop Arduino projects avoiding common wiring, power, and code pitfalls.
Backup
Implement reliable backup strategies avoiding data loss, failed restores, and security gaps.
Autonomy
Expand agent capabilities by identifying tasks where human approval adds no value. Systematic delegation.