Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add AshtonAU/pear-plugin --skill pear-icloudgit clone --depth 1 https://github.com/AshtonAU/pear-pluginWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/ashtonau/pear-plugin/pear-icloud)<a href="https://agentmods.dev/skills/ashtonau/pear-plugin/pear-icloud"><img src="https://agentmods.dev/badge/skills/ashtonau/pear-plugin/pear-icloud/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/ashtonau/pear-plugin/pear-icloud"><img src="https://agentmods.dev/badge/skills/ashtonau/pear-plugin/pear-icloud.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00061 | $0.02946 |
| Opus 5 | $0.00030 | $0.01473 |
| Sonnet 5 | $0.00012 | $0.00589 |
| Haiku 4.5 | $0.00006 | $0.00295 |
Grade A, and why
Pear - iCloud Calendar, Reminders, Contacts & Mail scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 273 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Pear — iCloud Integration
Pear provides read/write access to iCloud Calendar, Reminders, Contacts, and Mail through 34 MCP tools. All tools are prefixed with pear_ and communicate with iCloud via CalDAV/CardDAV for Calendar, Reminders, and Contacts, plus IMAP/SMTP for Mail.
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
- Read, send, or organize iCloud Mail
- Find free time slots or schedule meetings
- Build a daily briefing from events, reminders, and unread email
- 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"
- "Unread email", "inbox", "send an email", "reply to this email"
- "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)
- 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 tohttps://pearmcp.com/api/mcp)
Tool Reference
Events (8 tools)
| Tool | Description |
|---|---|
pear_list_calendars |
List all iCloud calendars (including read-only subscriptions) |
pear_list_events |
List events in a time range, with pagination and calendar filtering |
pear_search_events |
Search events by title or description within a date range |
pear_create_event |
Create an event with optional recurrence, alarms, attendees, and location |
pear_update_event |
Update an existing event's properties |
pear_delete_event |
Delete an event by filename |
pear_find_free_slots |
Find available time slots of a given duration |
pear_check_availability |
Check if a specific time slot is free, returns conflicts |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 9d ago First seen · 273 lines · 61 tokens per session scan A 408d264ffe5e
Pear - iCloud Calendar, Reminders, Contacts & Mail is a skill published in the GitHub repository AshtonAU/pear-plugin (6 stars, last pushed 5mo ago), licensed MIT. It adds 61 tokens to every session and 2,946 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
quick-win-session
Generates guided first-action flows that help users achieve a meaningful result within 60 seconds to boost retention. Use when user wants quick win onboarding, time-to-value optimization, or first success moments.
c-calendar
View and create calendar events via gog (Google Calendar) or icalBuddy (Apple Calendar). Check availability, list upcoming events, create/update/delete events, and manage multiple calendars.
c-notes
Manage Apple Notes and Apple Reminders from the CLI. Uses memo for Notes and remindctl for Reminders. Supports listing, searching, reading, creating notes, and adding/completing reminders.
vamoose
Book time off without the busywork. Prompts for your dates and subject, creates a calendar hold shown as free, invites your manager to approve it, then fans the event out to your team as optional attendees once approved. Backs onto Microsoft 365, Outlook, and Teams via Microsoft Graph, or Google Calendar. Trigger when…
gnomon
Use the gnomon MCP server's deterministic tools whenever a request depends on the current date/time, involves arithmetic past trivial mental math, mixes timezones, parses natural-language dates, counts business days, or needs unit conversion. Stop next-token-guessing math and time.
apple-notes
Manage Apple Notes via memo CLI: create, search, edit.