Pear iCloud Integration for Openclaw

A comprehensive suite of 27 MCP tools that provides read/write access to iCloud Calendar, Reminders, and Contacts through Pear's CalDAV and CardDAV bridge.

ashtonau
v1.0.2
Feb 14, 2026
0
1.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install pear-apple

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install pear-apple 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 Pear iCloud Integration?

The Pear iCloud integration is a robust toolset designed for developers using Openclaw Skills to connect AI agents with the Apple ecosystem. By leveraging standard CalDAV and CardDAV protocols, this skill enables agents to perform complex scheduling, task management, and contact organization tasks without requiring local macOS scripting.

This skill serves as a bridge for PIM (Personal Information Management), allowing for the creation of sophisticated AI assistants that can manage daily agendas, find optimal meeting times, and keep contact databases synchronized across the iCloud cloud infrastructure. It provides a secure, API-driven way to interact with user data using app-specific passwords and a dedicated API key.

Pear iCloud Integration Use Cases

  • Checking daily agendas, upcoming events, or general schedule availability.
  • Creating and updating calendar events with support for recurrence, attendees, and location.
  • Managing to-do lists and reminders, including setting priorities and marking tasks as complete.
  • Performing contact lookups or bulk updates to contact groups and vCard data.
  • Generating AI-scored meeting slots that account for work hours and user preferences.

How Pear iCloud Integration Works

  1. The user provides a Pear API key and connects their iCloud account using an Apple app-specific password.
  2. When a request is made, the agent selects the appropriate pear_ tool from the 27 available functions.
  3. The skill communicates with iCloud via the CalDAV or CardDAV protocols to fetch or modify data.
  4. For complex tasks like scheduling, the skill uses AI-scoring logic to evaluate free slots against user preferences.
  5. Changes are committed to the iCloud server and synchronized across all of the user's Apple devices instantly.

Pear iCloud Integration Setup

To integrate these Openclaw Skills, you must first obtain a Pear API key and an Apple app-specific password.

# Set your Pear API key in your environment
export PEAR_API_KEY="pear_sk_your_key_here"

# Optional: Set a custom MCP URL if not using the default
export PEAR_MCP_URL="https://pearmcp.com/api/mcp"

Ensure you have authorized your iCloud account on the Pear dashboard before initiating requests.

Pear iCloud Integration Data Schema & Taxonomy

The skill organizes data according to standard Apple PIM structures:

Category Protocol Key Data Points
Events CalDAV ISO 8601 timestamps, recurrence objects, attendee lists, location
Reminders VTODO Title, due dates, priority levels (1-9), completion status
Contacts CardDAV vCard fields (phones, emails, addresses, birthdays, Base64 photos)
Briefings Aggregated Combined view of today's events and pending tasks
Batches JSON Array Supports up to 50 items per request for bulk operations

Pear iCloud Integration Advanced Features

  • AI-scored optimal meeting slots using pear_find_best_time which considers buffers and work hours.
  • Idempotency keys for event creation to prevent duplicate entries during network retries.
  • Batch processing capabilities for creating or deleting up to 50 events, reminders, or contacts at once.
  • Automatic contact enrichment for event attendees in the daily briefing tool.
  • Synthesized birthday calendar support that generates events from contact birthday fields.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*