apple-ecosystem

name	apple-ecosystem
description	Use Fae's Apple ecosystem tools — Contacts, Calendar, Reminders, Notes, and Mail — to manage the user's information and productivity.
metadata	{"author":"fae","version":"1.0"}

Fae integrates with five core Apple apps through dedicated tools. Each requires explicit user permission.

Permission Model

If you try a tool and permission hasn't been granted, the system will prompt the user. If they decline, respect their choice — never repeatedly request the same permission. Explain what you could do with access and suggest they enable it later in Settings.

---

Contacts (3 tools)

Tool	Type	Purpose
search_contacts	Read	Search contacts by name, email, or phone
get_contact	Read	Get full details for a specific contact
create_contact	Write	Create a new contact entry

When the user mentions a person by name, look up their contact to personalise your response (e.g. "call Sarah" → find Sarah's phone number).

---

Calendar (5 tools)

Tool	Type	Purpose
list_calendars	Read	List all calendar sources
list_calendar_events	Read	List events in a date range
create_calendar_event	Write	Create a new calendar event
update_calendar_event	Write	Modify an existing event
delete_calendar_event	Write	Remove a calendar event

Always confirm before creating, modifying, or deleting events. When creating events, check for conflicts first using list_calendar_events. Be specific about dates, times, and time zones.

---

Reminders (4 tools)

Tool	Type	Purpose
list_reminder_lists	Read	List all reminder lists
list_reminders	Read	List reminders (optionally filtered by list)
create_reminder	Write	Create a new reminder
set_reminder_completed	Write	Mark a reminder as complete

When the user says "remember to..." or "remind me to...", create a reminder. Suggest a reasonable due date when they don't specify one.

---

Notes (4 tools)

Tool	Type	Purpose
list_notes	Read	List notes (optionally filtered by folder)
get_note	Read	Get full content of a specific note
create_note	Write	Create a new note
append_to_note	Write	Append content to an existing note

Use notes for longer-form content — meeting summaries, research findings, lists, drafts. Prefer append_to_note over creating duplicates.

---

Mail (3 tools)

Tool	Type	Purpose
search_mail	Read	Search emails by sender, subject, or content
get_mail	Read	Get full content of a specific email
compose_mail	Write	Compose and send an email

Always confirm recipient and content before sending. Summarise long email threads concisely. When composing replies, match the tone of the conversation.

---

Extended Apps via AppleScript

For apps without dedicated tools, use bash with osascript (requires DesktopAutomation permission):

• Messages — osascript -e 'tell application "Messages" to send "text" to buddy "name"'
• Shortcuts — shortcuts run "Shortcut Name"
• Music — osascript -e 'tell application "Music" to play'
• Safari — osascript -e 'tell application "Safari" to open location "url"'
• Finder — osascript -e 'tell application "Finder" to ...'

These are best-effort and may require macOS Automation permission.

---

Proactive Patterns

• When the user mentions a person by name → look up their contact
• When creating a task → suggest adding a reminder with a due date
• When the user mentions a meeting → check calendar for conflicts
• When composing an email → look up the recipient's contact for their address
• Never spam — offer capabilities when relevant, do not force them