pear

---

What is Pear?

Pear is a hosted MCP server that connects Claude Code to your iCloud Calendar, Reminders, Contacts, and Mail. Ask Claude to check your schedule, create events, manage reminders, look up contacts, read inbox context, and find meeting times through natural language.

> "What's on my calendar today?"
> "Schedule a 45-minute meeting with Sarah this week"
> "Remind me to submit the report by Friday"
> "What's John's phone number?"
> "Show me unread iCloud Mail from today"
> "Find me 3 free slots for a 2-hour workshop next week"

Works on macOS, Linux, and Windows via CalDAV/CardDAV for Calendar, Reminders, and Contacts, plus IMAP/SMTP for iCloud Mail. No Apple hardware required.

Install

1. Get a Pear API Key

Sign up at pearmcp.com, connect your iCloud account, and generate an API key.

You'll need an Apple app-specific password to connect your iCloud account. If you want Mail support, connect using the real @icloud.com address or iCloud Mail custom-domain address tied to that mailbox.

2. Set Your API Key

export PEAR_API_KEY=pear_sk_your_key_here

3. Choose an install path

Option A — Claude Plugin:

/plugin marketplace add AshtonAU/pear-plugin
/plugin install pear@pear-marketplace

Option B — MCP Server (direct):

claude mcp add --transport http pear https://pearmcp.com/api/mcp \
  --header "Authorization: Bearer $PEAR_API_KEY"

Option C — OpenClaw Skill:

clawhub install ashtonau/pear-apple

4. Verify

/pear:pear-setup

Already installed the marketplace? Refresh it with:

/plugin marketplace update pear-marketplace

What You Get

• 34 MCP tools across Calendar, Reminders, Contacts, Mail, scheduling, and batch operations
• Claude slash commands for common flows like setup, briefing, and scheduling
• One OpenClaw skill for users who want the same Pear integration outside Claude Code
• A direct MCP config via .mcp.json for manual setups

Repo Layout

This repo is intentionally small. Each top-level path maps to a specific client surface:

Path	Purpose
.claude-plugin/	Claude plugin and marketplace metadata
commands/	Claude slash commands such as /pear:briefing
skills/pear-icloud/	OpenClaw skill definition
.mcp.json	Direct MCP server config template
README.md	User-facing install and usage guide

34 MCP Tools

Domain	Tools	What You Can Do
📅 Calendar	8	List calendars, create/read/update/delete events, find free slots, check availability
✅ Reminders	5	Create/read/update/complete/delete reminders with priorities and due dates
👤 Contacts	9	Full CRUD for contacts and groups, photo management, smart search
🧠 Scheduling	1	AI-scored optimal meeting times based on preferences and conflicts
⚡ Batch	4	Bulk create/delete up to 50 items per call
✉️ Mail	7	List folders, read email, send email, move, mark read/unread, and delete

Slash Commands

Command	Description
/pear:briefing	Today's events and reminders at a glance
/pear:schedule	Find the best time for a meeting
/pear:pear-setup	Verify your connection

Highlights

• 🎂 Virtual Birthdays — Birthday events auto-generated from contact data
• 🧠 AI Scheduling — Scores time slots by work hours, preferences, and conflicts
• 👥 Attendee Resolution — Event attendees matched to your contacts automatically
• ✉️ iCloud Mail — Read inbox context, send replies, and manage email folders through the same hosted MCP endpoint
• ⚡ Batch Operations — Create up to 50 events/reminders/contacts in one call
• 🌍 Timezone Support — Full IANA timezone handling across all operations
• 🔒 Privacy First — Your data is proxied in real-time, never stored on Pear's servers

How It Works