A specialized automation skill for AI agents to programmatically access and read emails from the native Apple Mail application on macOS.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install apple-mail-moltbot-skill
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-moltbot-skill 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 Skill?
This skill leverages AppleScript (osascript) to bridge the gap between AI coding agents and the native Apple Mail client on macOS. It provides a suite of Python-wrapped scripts that allow for deep introspection of the local mail environment, including account listing, mailbox navigation, and message retrieval. As a key component of the Openclaw Skills ecosystem, it enables developers to build sophisticated email-aware agents that can process local communications without needing complex IMAP/SMTP configurations.
By operating directly through the system's osascript interface, the skill ensures that all interactions are handled through the user's existing authenticated sessions in Apple Mail. This makes it an ideal solution for developers looking to integrate local email context into their automated workflows, research tasks, or summary generation pipelines while maintaining the security of the native macOS environment.
Apple Mail Skill Use Cases
- Monitoring specific mailboxes for new incoming messages or critical alerts.
- Developing automated summaries of unread emails using an AI agent.
- Searching through historical email archives across multiple accounts for specific metadata or senders.
- Integrating local email context into broader project management or automated research workflows using Openclaw Skills.
- Identifying and filtering messages based on read status to streamline communication management.
How Apple Mail Skill Works
- The AI agent identifies all configured mail accounts (e.g., iCloud, Gmail, Work) on the macOS system.
- The agent queries a specific account to map out its folder hierarchy and available mailboxes.
- A list of recent messages is retrieved from a chosen mailbox, including metadata like subject lines, senders, and message IDs.
- Using a specific message ID, the agent fetches the full body content for detailed analysis or summarization.
- All data is returned in a standardized JSON format for easy parsing and logic execution.
Apple Mail Skill Setup
To utilize this skill within the Openclaw Skills framework, ensure you are running on macOS with the Mail app configured.
# Ensure Apple Mail is running before execution
# List available accounts to verify connectivity
python3 scripts/list_accounts.py
# List mailboxes for a specific account
python3 scripts/list_mailboxes.py "Your Account Name"
Note: On first run, macOS may prompt for automation permissions. You must allow your terminal or agent to control Apple Mail in System Settings.
Apple Mail Skill Data Schema & Taxonomy
The skill organizes its output into structured JSON objects for consistent integration:
| Data Type | Description | Key Fields |
|---|---|---|
| Accounts | List of active mail accounts | accounts, count |
| Mailboxes | Folder structure for an account | account, mailboxes, count |
| Message List | Metadata for messages in a mailbox | id, subject, sender, read_status |
| Full Content | The complete email body and details | subject, sender, content, date_sent |
Apple Mail Skill Advanced Features
- Support for persistent message IDs to track emails over time without re-scanning.
- Flexible message retrieval limits to optimize performance when dealing with high-volume mailboxes.
- Standardized error handling providing detailed JSON responses for robust agent-based debugging.
- Multi-account support allowing agents to aggregate data from personal and professional accounts simultaneously.
- Seamless integration with other Openclaw Skills for cross-app automation on macOS.
SKILL.md
Loading
Related Openclaw Skills
Multi-Viewpoint Debates
An AI-driven framework for stress-testing decisions by spawning conflicting agent personas to expose blind spots through debate.
Radon AI
A specialized MCP server that provides AI agents with deep visibility into React Native environments, including logs, network traffic, and real-time documentation.
Video Download FaaS
An asynchronous background video downloader that utilizes yt-dlp and FaaS isolation to deliver standardized MP4 files.
Obsidian Conversation Backup
A robust shell-based utility for automatically backing up and formatting Clawdbot AI conversations directly into your Obsidian vault using beautiful chat-style Markdown.
Apple Mail Management Expert
An AI-powered assistant for Apple Mail that automates inbox triage, organization, and productivity workflows to help you reach inbox zero.
LaunchThat OpenClaw Connector
A specialized bridge for connecting OpenClaw VPS instances to LaunchThatBot with secure authentication and event reporting.
Featured*
