Explore the tools Pear can expose to your AI client.

Inspect connected provider capability, readiness, draftability, and executability without reading provider data.

Run read-only Apple setup diagnostics across iCloud Calendar, Reminders, Contacts, IMAP, and SMTP without exposing secrets.

Create a non-executing ProviderDraftArtifact for an intended write tool. The payload must already satisfy the named write tool contract. For recurring Apple event updates, use scope this_occurrence_only with a listed recurrenceId, or scope entire_series without recurrenceId. Recurring deletes also support this_and_future with a listed recurrenceId. Dry-run payloads must be called directly and cannot enter approval. Requires permission for the underlying write tool named in toolName.

Create a typed, non-sending email draft artifact from direct recipient, subject, body, and provider fields. This never sends mail. Pass the returned draftArtifact to pear_approve_write_draft with toolName pear_send_email, then execute only after approval.

Turn a ProviderDraftArtifact into an approved exact execution request and approval-ledger entry without executing the provider write. Inline entries may be carried across a storage outage, but every provider write still requires durable persistence and an atomic claim.

Atomically claim a durable approved write, execute it at most once, then persist the provider receipt. Server-trusted approval requires ledgerId; outside that mode a canonical approvalLedgerEntry may first be durably materialized. Storage or claim failure occurs before any provider effect.

Record a provider execution receipt against an approved write request and update its approval-ledger entry without executing a provider write.

List available calendars with offset/limit pagination. Provider/accountId are optional; Pear uses your default calendar account when omitted.

List calendar events within a canonical timeRange object: { start, end } using ISO 8601 date-times. Use calendarNames to include 1-16 exact calendar names, ids, or URLs. If a selector returns NOT_FOUND, do not repeat it: call pear_list_calendars, choose an exact current selector returned by that call, and retry without broadening the requested calendar scope. Provider/accountId are optional; Pear uses your default calendar account when omitted.

Search calendar events using valid ISO 8601 start and end date/time values; start must be before end, and the search range must be 366 days or less. Use calendarNames to include 1-16 exact calendar names, ids, or URLs. Provider/accountId are optional; Pear uses your default calendar account when omitted.

Get one calendar event by filename. Provider/accountId are optional; Pear uses your default calendar account when omitted.

Create a calendar event. Provider/accountId are optional; for Apple, specify an exact calendar URL when more than one writable visible calendar is available.

Update a calendar event. Recurring Apple events require explicit scope: use this_occurrence_only with the recurrenceId returned by list/search, or entire_series without recurrenceId. Set dryRun true for an Apple-only, no-write impact preview. Updating this and future occurrences is not supported. Provider/accountId are optional; Pear uses your default calendar account when omitted.

Delete a calendar event. Recurring Apple events require explicit scope: use this_occurrence_only or this_and_future with the recurrenceId returned by list/search, or entire_series without recurrenceId. Set dryRun true for an Apple-only, no-write impact preview. Provider/accountId are optional; Pear uses your default calendar account when omitted.

Mark a calendar event as cancelled without claiming attendee notifications were sent. Apple-only until provider-neutral cancellation semantics exist.

Find available time slots across all visible calendars, one calendarName, or 1-16 exact calendarNames. Provider/accountId are optional; Pear uses your default calendar account when omitted.

Check whether a time slot is available across all visible calendars, one calendarName, or 1-16 exact calendarNames. Provider/accountId are optional; Pear uses your default calendar account when omitted.

List reminder/task lists. Provider/accountId are optional; Pear uses your default reminders account when omitted.

List reminders/tasks. Provider/accountId are optional; Pear uses your default reminders account when omitted.

Get one reminder/task by filename. Provider/accountId are optional; Pear uses your default reminders account when omitted.

Create a reminder. Provider/accountId are optional; for Apple, specify an exact list URL when more than one writable visible list is available.

Create a reminder from safe email metadata. Apple/iCloud only for now; requires mail metadata and reminders write access, and uses the same approval flow as reminder writes.

Update a reminder. Provider/accountId are optional; Pear uses your default reminders account when omitted.

Mark a reminder as completed. Provider/accountId are optional; Pear uses your default reminders account when omitted.

Delete a reminder. Provider/accountId are optional; Pear uses your default reminders account when omitted.

List contacts. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Search contacts. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Resolve a person from contacts with explicit resolved, ambiguous, or not_found status. Use before drafting email, invites, or contact writes.

Get one contact by filename. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Create a contact. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Update a contact using filename from pear_search_contacts, pear_list_contacts, pear_resolve_person, or pear_get_contact. Include addressBookUrl when present, rerun resolution if NOT_FOUND, and do not guess filenames. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Delete a contact. Provider/accountId are optional; Pear uses your default contacts account when omitted.

List contact groups. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Create a contact group. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Delete a contact group by filename, groupId, or groupName. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Add a contact to a group. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Update a contact photo. Provider/accountId are optional; Pear uses your default contacts account when omitted.

Find the best meeting time across all visible calendars, one calendarName, or 1-16 exact calendarNames. Provider/accountId are optional; Pear uses your default calendar account when omitted.

Create multiple events. Provider/accountId are optional at the top level only; each Apple event needs an exact calendar URL when its writable visible target is ambiguous.

Create multiple reminders. Provider/accountId are optional at the top level only; each Apple reminder needs an exact list URL when its writable visible target is ambiguous.

Create multiple contacts. Provider/accountId are optional at the top level only; Pear uses your default contacts account when omitted.

Delete multiple contacts. Provider/accountId are optional at the top level only; Pear uses your default contacts account when omitted.

List mail folders. Provider/accountId are optional; Pear uses your default mail account when omitted.

List email metadata. Provider/accountId are optional; Pear uses your default mail account when omitted.

Build a deterministic read-only digest of email metadata with priority and category signals. Provider/accountId are optional; Pear uses your default mail account when omitted.

Get recent read-only mail metadata for a resolved contact or exact email address. Apple/iCloud only for now; requires contacts read and mail metadata access.

Read a bounded email body in text or HTML. Follow bodyNextOffset with bodyOffset while bodyHasMore is true. Provider/accountId are optional; Pear uses your default mail account when omitted.

Inspect safe unsubscribe headers for one email without opening links, sending email, or making network requests. Apple/iCloud only for now.

List your non-destructive mail workflow rules that tune digest priority and category behavior without changing provider mailboxes.

Create a non-destructive mail workflow rule for digest priority/category behavior. Requires write approval and never moves, sends, deletes, marks, or unsubscribes email.

Update a non-destructive mail workflow rule. Requires write approval and never mutates provider mailbox state.

Delete a mail workflow rule. Requires write approval and does not touch provider mailboxes.

Suggest a non-destructive mail workflow rule from one email metadata record. Read-only; returns a pear_create_mail_rule payload but does not create the rule.

Extract bounded, resumable text from one supported email attachment, including plain-text files and text-based PDFs. Pro only. Select attachmentIndex or attachmentId from pear_read_email across Apple/iCloud, IMAP, Google, and Microsoft mail.

Send an email. Provider/accountId are optional; Pear uses your default mail account when omitted.

Request an unsubscribe action from a previously inspected option. Requires write approval; one-click sends exactly one HTTPS POST and never follows redirects, mailto prepares a separate send-email draft, and manual URLs are never fetched.

Move an email. Provider/accountId are optional; Pear uses your default mail account when omitted.

Mark an email as read or unread. Provider/accountId are optional; Pear uses your default mail account when omitted.

Delete an email. Provider/accountId are optional; Pear uses your default mail account when omitted.