1. Prepare the account and key
Sign up at pearmcp.com, connect iCloud or Microsoft 365, then create a Pear API key in Settings. Make PEAR_API_KEY available to the OpenClaw process through its local environment or secret manager. Do not place the key in the command below or in a shared file.
2. Save the hosted Pear server
OpenClaw stores remote servers under mcp.servers. This command uses the documented streamable-http transport and substitutes ${PEAR_API_KEY} from the environment. Keep the Bearer prefix.
openclaw mcp set pear '{"url":"https://pearmcp.com/api/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${PEAR_API_KEY}"}}'
openclaw mcp doctor pear --probeopenclaw mcp doctor without --probe does not connect. Reload refreshes only the current CLI process, so start a new OpenClaw session before using Pear. OpenClaw can also start an OAuth login. Pear has not certified that registration flow for OpenClaw, so use the header above.
3. Verify a real tool result
Ask OpenClaw to call pear_provider_status and name the ready services. Then ask for one known event. A description of a calendar check is not a completed read.
- Which Pear providers are ready for this account?
- Find one event I already know, in a narrow date range and the correct timezone.
- Preview a follow-up email for that event. Do not send it.
External ClawHub skill
The package @ashtonau/pear-apple version 1.0.2 is a separately maintained Apple-focused skill. It is not this hosted connection and it does not cover Microsoft 365. Review the current ClawHub files before installing, and keep the API key out of the install command.
openclaw skills verify @ashtonau/pear-apple --version 1.0.2 openclaw skills install @ashtonau/pear-apple --version 1.0.2
Apple Reminders compatibility
Apple Reminders availability depends on the Apple account. For Apple, Pear can read and write only the legacy reminder lists Apple still exposes through CalDAV. If the account has been upgraded to Apple's newer Reminders store, Pear cannot access those native lists and does not copy them into a separate reminder store. Apple may instead return compatibility placeholders, such as repeated "Where are my reminders?" items; Pear did not create them. Pear's safe fallback hides known placeholders and blocks writes to affected lists. Reconnecting iCloud or replacing the App-Specific Password will not change this Apple limitation. Calendar, Contacts, and Mail are unaffected, and Microsoft To Do uses Microsoft Graph and is unaffected. Full modern Apple Reminders access would require an Apple-platform companion using EventKit with the user's permission; Pear does not currently provide one.
Read the Apple Reminders compatibility noteWhat the hosted connection is for
- Read calendar, contacts, and mail for the providers connected in Pear.
- Use Microsoft To Do through Microsoft 365. The external skill does not add that path.
- Stop at a draft preview before approving any write.
OpenClaw workflows worth testing
- Summarize today's events after a real provider-status result.
- Search free time before the agent proposes a meeting.
- Revoke the Pear key, then remove the saved server, to end access.
