A read-only utility to fetch Mail, Calendar, Notes, and Stocks data from macOS in structured JSON format for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macos-suite-readonly
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-readonly 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 Read-only?
The macOS Suite Read-only skill provides a secure, non-destructive way for AI agents to interact with native Apple applications. By leveraging Python and AppleScript, this tool allows users of Openclaw Skills to extract unread email summaries, upcoming calendar schedules, searchable notes, and real-time stock market quotes without modifying any existing data.
All commands are optimized to output single JSON objects, making them exceptionally easy for LLMs and automated workflows to parse and analyze. This bridge between the macOS ecosystem and AI agents ensures that your personal information remains accessible for context-aware tasks while maintaining high security standards through macOS's native permission system.
macOS Suite Read-only Use Cases
- Summarizing unread emails for a daily morning briefing.
- Checking calendar availability and upcoming appointments for the day.
- Retrieving specific information from Apple Notes using keyword searches.
- Monitoring stock prices and market performance directly through the terminal or an agent.
- Providing context from local apps to enhance Openclaw Skills automated responses.
How macOS Suite Read-only Works
- The AI agent or user executes a Python command via the main script entry point.
- The script utilizes osascript to send AppleScript commands to the target macOS application (e.g., Mail or Notes).
- macOS checks for the necessary Automation and Privacy permissions before allowing the data access.
- The native application returns the requested data to the script.
- The skill processes the raw output and formats it into a standardized JSON structure for the agent to consume.
macOS Suite Read-only Setup
To get started with this skill within the Openclaw Skills framework, ensure you are running on macOS and have Python 3 installed.
# Check for python3
python3 --version
# Basic command usage
python3 ./scripts/main.py mail.unread_count
Note: Upon the first execution, macOS will prompt you for permission to access your Mail, Calendar, or Notes. You must grant these permissions in System Settings > Privacy & Security > Automation for the skill to function correctly.
macOS Suite Read-only Data Schema & Taxonomy
The skill returns structured data for each command to ensure compatibility with Openclaw Skills agents:
| Domain | Command | Key Fields in JSON |
|---|---|---|
mail.unread_list |
subject, sender, date, content_snippet |
|
| Calendar | calendar.list |
title, start_date, end_date, location |
| Notes | notes.search |
title, id, folder, body_preview |
| Stocks | stocks.quote |
symbol, price, change_percent, market_cap |
macOS Suite Read-only Advanced Features
- Support for batch stock queries to minimize API calls and script executions.
- Configurable limits for unread mail and calendar lists to manage token usage.
- Deep searching within specific Apple Notes folders for targeted information retrieval.
- Error handling that returns ok=false or specific warnings if system permissions are denied.
- Native integration with Openclaw Skills for seamless multi-app data synthesis.
SKILL.md
Loading
Related Openclaw Skills
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.
McKinsey PPT Design Framework
Automate the creation of professional, consultant-grade PowerPoint presentations using a McKinsey-style design framework and python-pptx.
macOS Suite
A powerful automation toolkit for controlling native macOS applications including Mail, Calendar, Reminders, and Notes via AI-driven commands.
SiliconFlow Image Generation
A high-performance image generation skill for AI agents leveraging the SiliconFlow API for FLUX and Stable Diffusion models.
Featured*
