pear-apple

What This Skill Does

The pear-apple skill provides a robust bridge between OpenClaw and your Apple iCloud ecosystem. Utilizing the CalDAV and CardDAV protocols, this skill grants read/write access to your Calendar, Reminders, and Contacts. With 27 distinct tools, it functions as a personal assistant capable of scheduling meetings, managing complex to-do lists, and retrieving contact information instantly. Whether you are looking to audit your daily schedule or perform bulk management of events and tasks, pear-apple ensures your Apple personal information management (PIM) data is always at your fingertips.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/ashtonau/pear-apple. Before using the tools, ensure you have an active Pear account at pearmcp.com. You must generate an App-Specific Password via your Apple ID settings and use it along with your PEAR_API_KEY to authenticate the connection. Set the PEAR_API_KEY environment variable in your OpenClaw configuration file to enable communication with the iCloud services.

Use Cases

This skill is ideal for professionals needing to reconcile multiple calendars, individuals managing extensive grocery or task lists, and users who frequently update contact information. You can use it to find available gaps in your busy week, automate the addition of recurring reminders, or perform mass updates to event details without opening the native Apple apps. It is particularly powerful for generating daily briefings, allowing you to start your day with a clear view of your meetings and top-priority tasks.

Example Prompts

1. "What does my schedule look like today, and do I have any pending reminders due this afternoon?"
2. "Find a one-hour free slot next Tuesday between 9 AM and 5 PM and schedule a sync meeting with the project team."
3. "What is the phone number for Sarah Jenkins, and can you add a reminder to call her at 4 PM today?"

Tips & Limitations

Note that this skill does not support Apple Notes, Mail, iMessage, or iCloud Drive. It is strictly limited to CalDAV and CardDAV data. When setting priorities for reminders, remember that 1 denotes high priority, 5 is medium, and 9 is low. Always ensure your iCloud app-specific password remains secure and do not share it outside of your encrypted environment. If you encounter sync delays, check your internet connection or verify that your iCloud credentials have not expired.