README file from
GithubApple Reminders Sync
An Obsidian plugin for macOS that pulls today's Apple Reminders into your daily note's TODO section.
Features
- Fetches incomplete reminders due today from Apple Reminders via reminders-cli (native EventKit, no AppleScript)
- Appends them as checklist items (
- [ ]) under the## TODOheading in today's daily note - Preserves reminder notes as indented text beneath each item
- Shows priority levels:
!!!(high),!!(medium),!(low) - Deduplicates automatically so re-syncing never creates repeated entries
- Syncs on a configurable interval and on vault open
- Configurable list exclusions (skip personal lists like Groceries)
Requirements
- macOS (Apple Reminders access requires EventKit)
- reminders-cli:
brew install keith/formulae/reminders-cli
Installation
Community plugins (once approved)
Settings > Community Plugins > Browse > search "Apple Reminders Sync"
Manual
- Download
main.jsandmanifest.jsonfrom the latest release - Create
.obsidian/plugins/apple-reminders-sync/in your vault - Place both files inside
- Enable in Settings > Community Plugins
Configuration
| Setting | Default | Description |
|---|---|---|
| Sync interval | 5 min | How often to pull from Apple Reminders |
| Daily notes folder | daily-notes |
Folder containing your daily notes |
| Excluded lists | Groceries, Watch list, Wish List | Comma-separated lists to ignore |
How it works
- On sync (automatic or manual), the plugin calls
reminders show-all --due-date today --format json - Filters out completed items and excluded lists
- Finds the
## TODOsection in today's daily note (<daily-notes-folder>/YYYY-MM-DD.md) - Appends any new reminders at the end of that section, skipping items already present
Daily note format
Your daily note needs a ## TODO section. The plugin appends reminders at the end of it:
## TODO
- [ ] Existing task from yesterday
- [ ] Schedule dentist appointment !!!
- [ ] Submit grant application
- PEDL deadline March 31
Trigger a manual sync with the ribbon icon (checkmark) or via the command palette.
Limitations
- macOS only (EventKit is not available on Windows/Linux/iOS)
- One-way sync: changes in Obsidian are not pushed back to Apple Reminders
- Requires
reminders-cliinstalled via Homebrew - Daily note must have a
## TODOheading