Setup & Installation
openclaw skills install @tyler6204/apple-mail
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install apple-mail
What This Skill Does
Integrates with Apple Mail.app on macOS to read, search, send, reply to, and manage emails. Uses AppleScript for mail operations and SQLite for fast metadata search without full enumeration. Mail.app must be running for most operations.
SQLite-based search queries mail metadata in ~50ms instead of the minutes AppleScript enumeration takes on large inboxes.
When to use it
- Search inbox for emails from a specific sender
- Send an automated reply to an email thread
- Bulk delete spam emails matched by keyword
- Mark multiple messages as read after processing
- List unread messages across different mailboxes
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Find all unread emails from my manager and reply that I will follow up tomorrow
AGENT
- 1Run mail-refresh.sh to sync the latest messages
- 2Run mail-fast-search.sh with the manager's email address to find matching messages
- 3Run mail-read.sh on the returned IDs to read the email bodies
- 4Run mail-reply.sh on each unread message ID with the follow-up reply text
- 5Run mail-mark-read.sh on the replied IDs to mark them as read
OUTPUT
Replies sent to all unread emails from the manager, each marked as read