> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enconvo.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Apple Ecosystem Integration
> Seamlessly integrate with Apple Mail, Reminders, Calendar, Contacts, Messages, Notes, Maps, and Shortcuts
## Overview
EnConvo deeply integrates with macOS native applications, letting you manage email, reminders, calendar events, contacts, messages, notes, and shortcuts through natural language. Because these integrations use native macOS APIs and AppleScript, they work offline, respect your system preferences, and feel like a natural extension of your Mac.
Read, compose, and manage emails
Create, update, and complete reminders
View, create, and manage events
Search and read contact details
Send iMessages to contacts
Create, read, and update notes
Look up addresses and directions
Run any shortcut from your system
## Apple Mail
The Apple Mail integration provides full email management through the native Mail app on your Mac.
### Available Tools
| Tool | Description |
| ------------------------ | ---------------------------------------------------------------------------- |
| **Compose New Message** | Create and send a new email with To, CC, BCC, subject, body, and attachments |
| **See Recent Mail** | View recent messages (optionally unread-only) |
| **See Mail Accounts** | List all configured email accounts |
| **Get Message Content** | Read the full content of a specific email |
| **Open Message in Mail** | Open a specific email in the Mail app |
| **Toggle Message Read** | Mark a message as read or unread |
| **Move to Archive** | Archive a specific email |
| **Move to Trash** | Move an email to the trash |
| **Delete Message** | Permanently delete an email |
| **Move to Mailbox** | Move an email to a specific mailbox |
| **Mark All as Read** | Mark all emails as read |
### Example Usage
```
"Show me my unread emails"
"Send an email to alice@example.com about the project deadline"
"Archive all emails from notifications@github.com"
"What did Bob say in his last email?"
```
### Configuration
| Setting | Description | Default |
| --------------- | ---------------------------------------- | ------- |
| **Unread-Only** | Only show unread messages in recent mail | On |
Apple Mail integration works with all email accounts configured in the macOS Mail app, including iCloud, Gmail, Outlook, and Exchange accounts.
## Apple Reminders
Create, manage, and track reminders with full support for due dates, priorities, recurrence rules, and location-based triggers.
### Available Tools
| Tool | Description |
| ---------------------------- | ------------------------------------------------------------------------------------- |
| **Add to Apple Reminders** | Create a new reminder with title, notes, due date, priority, recurrence, and location |
| **Get Reminders Events** | List all reminders across all lists |
| **Get Reminders Lists** | List all reminder lists |
| **Toggle Completion Status** | Mark a reminder as complete or incomplete |
| **Delete Reminder** | Remove a reminder |
| **Update Reminder** | Modify an existing reminder's title, notes, date, priority, recurrence, or location |
### Reminder Features
**Due dates and times:**
```
"Remind me to call the dentist tomorrow at 2pm"
"Add a reminder for the team standup every weekday at 9am"
```
**Priorities:**
```
"Create a high-priority reminder to submit the report by Friday"
```
**Recurrence rules:**
* Daily, weekly, monthly, or yearly frequency
* Custom intervals (e.g., every 2 weeks)
* End date or occurrence count
```
"Set a recurring reminder to review expenses on the first of every month"
```
**Location-based triggers:**
```
"Remind me to buy groceries when I arrive at the store"
```
### Recurrence Configuration
| Property | Description | Example |
| ----------------- | ---------------------- | -------------------------------------- |
| `frequency` | Recurrence type | `daily`, `weekly`, `monthly`, `yearly` |
| `interval` | Repeat every N periods | `2` (every 2 weeks) |
| `endDate` | When recurrence stops | `2025-12-31` |
| `occurrenceCount` | Number of occurrences | `10` |
## Apple Shortcuts
Run any Apple Shortcut installed on your system directly from EnConvo. The Shortcuts integration dynamically discovers all shortcuts available on your Mac.
### How It Works
EnConvo scans your system for all installed Apple Shortcuts and makes them available as tools
Ask the AI to run any shortcut by name -- no need to remember exact names
Pass text input to shortcuts and receive their output (both text and binary data are supported)
### Available Tools
| Tool | Description |
| ------------------ | --------------------------------------------------- |
| **List Shortcuts** | See all Apple Shortcuts available on your system |
| **Run Shortcut** | Execute a shortcut by name with optional text input |
### Example Usage
```
"Run my 'Morning Routine' shortcut"
"List all my shortcuts"
"Execute the 'Resize Image' shortcut with the file on my desktop"
```
### Siri Integration
Since Shortcuts work with Siri, you can create powerful automation chains:
1. Create a Shortcut in the Shortcuts app that calls EnConvo
2. Trigger it via Siri voice command
3. EnConvo processes the request using AI
4. Results flow back through the Shortcut
Combine Apple Shortcuts with EnConvo workflows for advanced automation. For example, a Shortcut can trigger an EnConvo workflow that uses AI to process data and then passes the result to another Shortcut.
## Apple Calendar
Full calendar management with support for creating, updating, deleting, and querying events, including recurrence rules, alarms, and all-day events.
### Available Tools
| Tool | Description |
| ------------------------- | -------------------------------------------------------------------------------------- |
| **Add to Calendar** | Create a new calendar event with title, dates, location, notes, alarms, and recurrence |
| **Update Calendar Event** | Modify an existing event |
| **Get Calendar Events** | Retrieve events for a specified number of days |
| **Delete Calendar Event** | Remove an event (optionally all recurrences) |
| **Get Calendar List** | List all available calendars |
### Event Features
**Basic events:**
```
"Schedule a team meeting tomorrow at 3pm for one hour"
"Add a dentist appointment on March 25th from 10am to 11am at 123 Main St"
```
**All-day events:**
```
"Block off next Friday as a personal day"
```
**Recurring events:**
```
"Create a weekly team standup every Monday at 9am"
"Schedule a monthly review on the first of each month"
```
**Alarms and reminders:**
```
"Schedule a meeting at 2pm with a 15-minute reminder"
"Add a 1-hour warning alarm to my flight tomorrow"
```
**Multiple calendars:**
```
"Add this event to my Work calendar"
"Show me events from all calendars for the next week"
```
### Event Properties
| Property | Description | Example |
| ----------------------- | ------------------------ | ------------------------------------ |
| `title` | Event title | `"Team Standup"` |
| `startDate` / `endDate` | Date range | `yyyy-MM-dd HH:mm:ss` format |
| `location` | Event location | `"Conference Room B"` |
| `notes` | Additional details | `"Bring Q4 report"` |
| `isAllDay` | All-day event flag | `true` / `false` |
| `url` | Associated URL | Meeting link |
| `alarms` | Alert offsets in seconds | `-3600` (1 hour before) |
| `recurrence` | Repeat rule | `{frequency: "weekly", interval: 1}` |
| `availability` | Busy/free status | `0` (free), `1` (busy) |
## Apple Contacts
Search and read entries from the macOS Contacts app.
### Available Tools
| Tool | Description |
| ----------------------- | ---------------------------------------------------- |
| **Search Contacts** | Look up a contact by name, phone, or email |
| **Get Contact Details** | Read full details (emails, phones, addresses, notes) |
### Example Usage
```
"What is Alice's phone number?"
"Find all contacts at Acme Corp"
"Get Bob's email address"
```
## Apple Messages
Send iMessage or SMS messages to anyone in your Contacts.
### Available Tools
| Tool | Description |
| ---------------- | ------------------------------------------------------------ |
| **Send Message** | Send an iMessage or SMS to a contact, phone number, or email |
### Example Usage
```
"Send a text to Alice saying I'll be 10 minutes late"
"Message Bob 'meeting pushed to 3pm'"
```
Apple Messages sending is limited by iMessage/SMS configuration on your Mac. The Messages app must be signed in to your Apple ID for iMessage delivery.
## Apple Notes
Full Notes integration including reading, writing, and observing the currently selected note.
### Available Tools
| Tool | Description |
| --------------------- | ------------------------------------------------------- |
| **Create Note** | Add a new note in a specified folder |
| **Get Notes** | List notes in a folder or across all folders |
| **Read Note** | Fetch a note's content by ID or title |
| **Update Note** | Modify an existing note |
| **Get Selected Note** | Return whatever note the user has selected in Notes.app |
### Example Usage
```
"Create a note titled 'Trip Checklist' with my packing list"
"Add today's meeting notes to my 'Work' folder"
"Summarize the note I have open"
```
The **Get Selected Note** tool lets the AI react to the note you are currently viewing — ideal for "summarize this" or "translate this" flows.
## Apple Maps
Query addresses, coordinates, and directions via the native Maps app.
### Available Tools
| Tool | Description |
| ------------------ | ------------------------------------- |
| **Search Address** | Look up a location by free-text query |
| **Get Directions** | Compute a route between two locations |
### Example Usage
```
"Where is 1 Infinite Loop?"
"Directions from my office to SFO by car"
```
## Required Permissions
These integrations use native macOS APIs and require appropriate system permissions.
Go to **System Settings** -> **Privacy & Security** -> **Accessibility** and enable EnConvo. This is required for reading screen content and interacting with apps.
When EnConvo first tries to control Mail, Reminders, Calendar, Contacts, Messages, Notes, or Shortcuts, macOS will prompt you to grant Automation permission for each app. Click **Allow**.
Grant EnConvo access to your calendars when prompted. Go to **System Settings** -> **Privacy & Security** -> **Calendars** if you need to change this later.
Grant EnConvo access to your reminders when prompted. Go to **System Settings** -> **Privacy & Security** -> **Reminders** if needed.
Grant EnConvo access to your contacts when prompted. Go to **System Settings** -> **Privacy & Security** -> **Contacts** if needed.
If you deny a permission prompt, the corresponding integration will not function. You can always re-enable permissions in **System Settings** -> **Privacy & Security**.
## Privacy
* All Apple ecosystem integrations operate entirely on your Mac using native macOS APIs
* No data is sent to external servers unless you explicitly ask the AI to process content (e.g., "summarize this email")
* Email content, reminders, and calendar events are accessed on demand -- nothing is cached or stored by EnConvo
* You can revoke permissions at any time through macOS System Settings
## Troubleshooting
Verify that the Mail app is configured with at least one email account. Check that EnConvo has Automation permission for Mail in **System Settings** -> **Privacy & Security** -> **Automation**.
Go to **System Settings** -> **Privacy & Security** -> **Calendars** and ensure EnConvo is listed and enabled. Restart EnConvo after granting permission.
Ensure EnConvo has Reminders access in **System Settings** -> **Privacy & Security** -> **Reminders**. Also verify that your reminders are synced and visible in the native Reminders app.
The Shortcuts integration dynamically scans your system. If a newly created shortcut does not appear, try restarting EnConvo. Shortcuts must be saved in the Shortcuts app (not just in iCloud).
## Related Features
Google Gmail integration via API
Slack, Discord, Telegram, Feishu
AI agents that use Apple tools automatically
Automate Apple app tasks in workflows