Sync Obsidian Tasks with Apple Reminders using obs-sync

obs-sync is a free, open-source CLI tool that bidirectionally syncs your Obsidian Tasks with Apple Reminders — so you get notifications and mobile access without leaving your markdown workflow.

Prerequisites

• macOS 10.15+
• Python 3.8+
• Obsidian with the Tasks plugin installed

Step 1 — Install

git clone https://github.com/BoweyLou/obssync.git
cd obssync
chmod +x install.sh
./install.sh --extras macos
source ~/.zshrc

Verify:

obs-sync --help

Step 2 — Grant Reminders Permission

Go to System Settings → Privacy & Security → Reminders and enable access for Terminal.

Step 3 — Create a Reminders List

In Apple Reminders, create a new list called “Obsidian Task” under your iCloud account (so it syncs to all your Apple devices).

Step 4 — Run Setup

obs-sync setup

• Select your Obsidian Task list when prompted
• Accept defaults for match score and other settings
• Enable hourly automation when asked (I found problem using this, so I disable it!)

Step 5 — Configure Tag Routing

To sync only tasks tagged #reminder, edit the config directly:

bash

nano ~/.config/obs-sync/config.json

Add your tag route inside the config:

"tag_routes": {
  "reminder": "YOUR-OBSIDIAN-TASK-LIST-UUID"
}

Find your list UUID from the setup output (e.g. 1A5D79A1-368B-47E5-A4C1-AF55722D4468).

Step 6 — Test

Add a task in any Obsidian note:

- [ ] My first synced task #reminder
- [ ] Task with due date #reminder 📅 2026-04-01

Preview:

obs-sync sync

Apply:

obs-sync sync --apply

How it works

DirectionWhat happensObsidian → Reminders#reminder tasks appear in your Obsidian Task listReminders → ObsidianCompletions and new tasks land in AppleRemindersInbox.md in your vaultAuto-syncRuns every hour via macOS LaunchAgent

Key Commands

bash

obs-sync sync              # dry run — preview only
obs-sync sync --apply      # apply bidirectional sync
obs-sync automation status # check scheduler health
obs-sync automation logs   # view recent sync logs
obs-sync update            # pull latest version