Apple Reminders Integration

Import Apple Reminders into Sunsama and sync completion status back to Apple Reminders.

Bring your Apple Reminders into your daily plan. Browse your Reminders lists in a panel beside your task list, import what you’ll work on, and completing the task in Sunsama completes the reminder too.

Apple Reminders works through Apple’s own API on your Mac, so it needs the Sunsama desktop app for macOS. On this page, “desktop app” means the macOS app.

Installation

There is no account to connect. In the desktop app:

  1. Go to Settings > Integrations > Apple Reminders.
  2. Turn on Enable Apple Reminders Integration Panel.
  3. Click Grant access if macOS hasn’t given Sunsama permission to read your Reminders yet.

If your desktop app is too old, the settings page asks you to Update desktop app. Anywhere else, it offers Download desktop app.

Browsing and importing reminders

Open Apple Reminders in the right hand panel of the desktop app, choose a list, and import a reminder into your task list.

  • Filter: show Incomplete or All reminders, and choose whether reminders already in Sunsama are hidden (Hide once imported) or shown (Show even if imported).
  • Sort: by Modified date, Created date, Deadline or None. None follows the order you have in Apple Reminders.
  • Search: type in the search bar to find a reminder in the list.

The reminder’s title, notes and priority are copied to the Sunsama task, and its due date is copied to the Sunsama due date. Dates are copied once, when you import, and don’t sync afterwards.

Working with imported tasks

An imported reminder becomes a Sunsama task linked to the original. Completion syncs both ways, as long as the reminder wasn’t deleted on import:

  • Completing the task in the desktop app or the iOS app completes the reminder.
  • Completing the reminder in Apple Reminders completes the Sunsama task, while the desktop app is open.

Automations

Configure these in Settings > Integrations > Apple Reminders.

“Delete Apple Reminder on Import?”

If this is enabled, Reminders will be deleted from your device (if they’re synchronized via iCloud, they’ll be deleted in all your devices) once you import them. Enable this if you do not wish to see them in Apple Reminders after importing them into Sunsama.

It’s off by default. When it’s off, nothing happens to the reminder when you import it, and its completion status syncs.

Sync Reminders Lists to Sunsama Channels

You can choose a specific channel or context from Sunsama to be mapped to a Reminders list, so that any Reminder imported (manually or automatically) from that list will be assigned to that channel.

Note: You cannot link “Today” or “Scheduled” Reminders lists to Sunsama channels.

Auto Import

Turn on Auto Import for a list to import its new reminders automatically. Sunsama checks for new reminders when you open the desktop app, and every minute while it’s open and focused. Each reminder lands on its due date, or on today if it has none or the date has passed.

Recurring reminders aren’t auto-imported, and the “Today” and “Scheduled” lists can’t be auto-imported.

Reminders with advanced fields

Apple’s API doesn’t share some “advanced” fields like assignee, section, subtasks, tags, location, or attachments (e.g. URL or images). If you have the setting enabled to delete reminders when they’re imported, this may result in permanent data loss.

Sunsama does have access to and can show a Reminder’s title, notes, due date, due time, priority, and whether it repeats.

Smart Lists

Unfortunately Apple’s API doesn’t allow access to any “Smart List”. We are, however, able to fetch due date information from reminders, so we can show the special “Today” and “Scheduled” lists.

Data access

We do not store any information from your Reminders unless you import them into Sunsama. When you do, the imported Sunsama task keeps the reminder’s title, notes, due date and priority.