apple-productivity

name	apple-productivity
description	Apple Productivity manages and coordinates Apple Calendar, Reminders, and Notes on macOS. Use for checking or changing schedules and reminders, creating or organizing Apple Notes, daily or weekly reviews, meeting preparation and follow-up, turning notes into tasks, and workflows that combine two or more Apple productivity apps.

Apple Productivity

Use apple-events for Calendar and Reminders. Use apple-notes for Notes. Prefer focused native tools over UI automation.

Route the request

• Use calendar_events for calendar event reads, creates, updates, and deletes.
• Use reminders_tasks, reminders_lists, and reminders_subtasks for reminders.
• Use Apple Notes tools such as search-notes, get-note-markdown, create-note, update-note, and move-note for notes.
• Follow each MCP tool's live schema. Do not invent fields the installed server does not expose.
• Read references/tool-routing.md when choosing an unfamiliar operation.
• Read references/workflows.md for daily reviews, meeting flows, or note-to-task conversion.
• Read references/permissions.md when macOS denies access or no permission entry appears.

Work safely

1. Resolve relative dates in the user's local timezone and show absolute dates when confirming a result.
2. Read or search first when updating, completing, moving, or deleting an existing item. Prefer returned IDs over titles.
3. Check for equivalent events or reminders before creating duplicates.
4. Preview and confirm deletions, bulk edits, recurring-event changes, shared-note edits, and destructive folder or list operations unless the user explicitly requested that exact change.
5. Search Notes narrowly. Retrieve full note bodies only for relevant results.
6. Inspect attachments before rewriting an existing note that may contain images, scans, PDFs, audio, or files. Create a new note when preservation is uncertain.
7. Verify writes by rereading the changed item. Report the calendar, reminder list, or Notes folder and effective date or time.
8. Never bypass macOS privacy controls. Identify the missing permission and pause when authorization is required.

Compose across apps

• For a daily review, combine the requested calendar window with incomplete, due, and overdue reminders. Read Notes only when explicitly requested or clearly relevant to a named project.
• For meeting preparation, confirm the event first, then narrowly search related notes and incomplete reminders.
• For meeting follow-up, preserve the source note, convert explicit actions into reminders, and create follow-up time blocks only when requested.
• When turning a note into reminders, show a compact proposal first if owners, dates, or target lists are ambiguous.

Notes formatting

Use simple HTML for structured notes: headings, <div> paragraphs, <ul> or <ol> lists, and basic inline emphasis. Do not promise native interactive checklists, collapsible headings, background highlights, or perfect preservation of complex rich text. Password-protected notes are unavailable.

Permission repair

Use scripts/repair_eventkit_permissions.py only after the user explicitly authorizes modifying the local mcp-server-apple-events installation. The script creates a backup, wraps the EventKit helper in a registered app bundle, and resets only that helper's Calendar and Reminders permission records.