Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Productivity
Pear Apple
iCloud Calendar, Reminders & Contacts via Pear. Manage events, reminders, contacts, daily briefings, and AI scheduling. 27 tools for Apple iCloud via CalDAV/...
skill openclawclawhub Free
iCloud Calendar, Reminders & Contacts via Pear. Manage events, reminders, contacts, daily briefings, and AI scheduling. 27 tools for Apple iCloud via CalDAV/...
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.0.2
Provenance
- Publisher
- AshtonAU
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Pear โ iCloud Integration
Pear provides read/write access to iCloud Calendar, Reminders, and Contacts through 27 MCP tools. All tools are prefixed with pear_ and communicate with iCloud via CalDAV/CardDAV protocols.
When to Use
Activate this skill when the user wants to: Check their schedule, upcoming events, or daily agenda Create, update, or delete calendar events Manage reminders or to-do lists Look up, create, or update contacts Find free time slots or schedule meetings Get a daily briefing of events and tasks Check availability for a specific time Work with contact groups Perform bulk operations on events, reminders, or contacts Activation triggers: "What's on my calendar", "my schedule", "upcoming events" "Remind me to", "add a reminder", "my tasks", "to-do" "Find contact", "add a contact", "phone number for" "Schedule a meeting", "find a time", "when am I free" "Daily briefing", "what's today look like" "Birthday", "anniversaries" Do NOT activate for: Apple Notes (not supported โ CalDAV only) Apple Mail or iMessage iCloud Drive or file storage Apple Music, Photos, or other non-PIM services Local macOS Calendar.app scripting (Pear works cross-platform via API)
Prerequisites
Required Environment Variable: PEAR_API_KEY โ Your Pear API key (format: pear_sk_...) Sign up at pearmcp.com Generate an API key from the dashboard Connect your iCloud account (requires an app-specific password) Optional: PEAR_MCP_URL โ Custom endpoint URL (defaults to https://pearmcp.com/api/mcp)
Events (8 tools)
ToolDescriptionpear_list_calendarsList all iCloud calendars (including read-only subscriptions)pear_list_eventsList events in a time range, with pagination and calendar filteringpear_search_eventsSearch events by title or description within a date rangepear_create_eventCreate an event with optional recurrence, alarms, attendees, and locationpear_update_eventUpdate an existing event's propertiespear_delete_eventDelete an event by filenamepear_find_free_slotsFind available time slots of a given durationpear_check_availabilityCheck if a specific time slot is free, returns conflicts
Reminders (4 tools)
ToolDescriptionpear_list_remindersList reminders with optional list filtering, includes completed togglepear_create_reminderCreate a reminder with optional due date, priority (1=high, 5=med, 9=low), and notespear_update_reminderUpdate a reminder's propertiespear_complete_reminderMark a reminder as completed
Contacts (9 tools)
ToolDescriptionpear_list_contactsList all contacts with full vCard data (phones, emails, addresses, birthdays)pear_search_contactsSearch by name, email, phone, or organizationpear_create_contactCreate a contact with full vCard support including photopear_update_contactUpdate contact fields (merges with existing data)pear_delete_contactDelete a contactpear_list_contact_groupsList all contact groups with member countspear_create_contact_groupCreate a new contact grouppear_add_contact_to_groupAdd a contact to a group by name or emailpear_update_contact_photoUpdate a contact's photo (Base64, data URI, or external URL)
Briefing (1 tool)
ToolDescriptionpear_get_daily_briefingGet today's events and pending reminders in one call. Enriches attendees with contact data.
Scheduling (1 tool)
ToolDescriptionpear_find_best_timeAI-scored optimal meeting slots. Considers work hours, time-of-day preference, day-of-week preference, buffer time, and reminder deadlines.
Batch Operations (4 tools)
ToolDescriptionpear_create_events_batchCreate up to 50 events in one callpear_create_reminders_batchCreate up to 50 reminders in one callpear_create_contacts_batchCreate up to 50 contacts in one callpear_delete_contacts_batchDelete up to 50 contacts in one call
Dates and Times
Always use ISO 8601 format: 2025-06-15T14:30:00Z or 2025-06-15T14:30:00+10:00 Timezone parameter: Pass timezone (IANA format like America/New_York or Australia/Sydney) for user-friendly display times All-day events: Set isAllDay: true and use date-only format 2025-06-15 Date ranges: pear_list_events requires a timeRange object: { start: "...", end: "..." }
Creating Events
When creating events, follow this pattern: If the user doesn't specify a calendar, omit calendarName โ Pear auto-selects the default For recurring events, use the recurrence object: { frequency: "WEEKLY", interval: 1, count: 10 } For attendees, you can pass names โ Pear resolves them against the user's contacts automatically Use idempotencyKey when retrying to prevent duplicate events Alarms use minutes before: { action: "display", trigger: 15 } for a 15-minute reminder
Finding Meeting Times
For scheduling, prefer pear_find_best_time over pear_find_free_slots: pear_find_best_time returns AI-scored slots considering work hours, preferences, and existing commitments Pass preferences to customize: { timeOfDay: "morning", focusTime: true, workHoursStart: 9, workHoursEnd: 17 } pear_find_free_slots is simpler โ just returns raw available slots without scoring
Reminders
Reminders are accessed via CalDAV (VTODO protocol) โ basic operations work well (title, due date, priority, notes, completion). Modern Apple Reminders features like subtasks, tags, smart lists, and location-based reminders are not available via CalDAV. Priority values: 1 = high, 5 = medium, 9 = low, 0 = none To list only incomplete reminders, use includeCompleted: false (default) Reminder lists are auto-created if they don't exist when using listName
Contacts
pear_update_contact merges fields โ it won't erase data you don't include in the update Birthday format: YYYY-MM-DD for full date, --MM-DD for year-unknown Phone/email can be a single string or an array for multiple entries Contact photos accept Base64 or data URI format
Virtual Birthdays
Pear generates all-day birthday events from contact birthday fields. These appear as events on a "Birthdays" calendar when listing events. This is a synthesized feature โ Apple's native Birthdays calendar is not exposed via CalDAV.
Daily Briefing
pear_get_daily_briefing is the most efficient way to give the user an overview: Returns today's events + pending reminders in a single call Automatically enriches event attendees with contact details (name, email, phone) Pass timezone for correct day boundaries Pass date to get a briefing for a different day
Actions Requiring Care
ActionRiskGuidancepear_delete_eventRemoves event permanentlyConfirm event title and date with user before deletingpear_delete_contactRemoves contact permanentlyAlways confirm โ show contact name firstpear_delete_contacts_batchBulk delete up to 50 contactsRequire explicit user confirmation with countpear_update_eventOverwrites event fieldsSummarize changes before applyingpear_complete_reminderMarks as doneSafe โ can be undone by updating completed: falseBatch create operationsCreates up to 50 itemsConfirm count and summarize before executing
Data Safety
Read operations are always safe โ listing, searching, and briefings have no side effects Updates merge, not replace โ pear_update_contact preserves fields you don't mention Batch operations are rate-limited โ chunks of 5 with 200ms delays, no need to throttle manually Never expose the user's PEAR_API_KEY โ treat it as a secret
Error Handling
Error CodeMeaningWhat to Do-32001Missing or invalid API keyCheck PEAR_API_KEY is set correctly-32602Invalid parametersCheck parameter names and types against tool reference-32603Server errorRetry once, then report to user404 on event/reminderItem not foundThe filename may have changed โ re-list to get current filenamesCalendar is read-onlyCannot modify subscription calendarsList calendars first to check which are writable
Error Recovery (Idempotency)
Event creation failed mid-request or timed out: โ Retry pear_create_event with the same idempotencyKey โ Pear deduplicates โ no double-booking even if the first request succeeded silently
Morning Briefing
User: "What's on my plate today?" โ Call pear_get_daily_briefing with timezone โ Summarize events chronologically, then pending reminders
Schedule a Meeting
User: "Find time for a 1-hour meeting this week" โ Call pear_find_best_time with durationMinutes: 60 and this week's range โ Present top 3 options with scores โ On user selection, call pear_create_event
Quick Reminder
User: "Remind me to call the dentist tomorrow" โ Call pear_create_reminder with title and dueDate set to tomorrow
Contact Lookup
User: "What's Sarah's phone number?" โ Call pear_search_contacts with query: "Sarah" โ Return matching contacts with phone numbers
Bulk Event Creation
User: "Add these 5 meetings to my calendar" โ Call pear_create_events_batch with all events in one request โ Summarize results (created count, any failures)
References
Pear Documentation Apple App-Specific Passwords CalDAV Protocol (RFC 4791) CardDAV Protocol (RFC 6352) IANA Timezone Database
Category context
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs
- SKILL.md