Obsidian Tasks Sync

A personal utility that mirrors Google Tasks into a private Obsidian notes vault.

What it does

Obsidian Tasks Sync is a small self-hosted script that keeps a single person's Google Tasks in step with their personal Obsidian note vault. It is not a product, a service, or a hosted platform: it runs on its author's own computer, for that author's own account only.

• Tasks created in Google Tasks appear as Markdown checklist items in the vault.
• Completing a task on either side marks it complete on the other.
• Titles, due dates and notes stay in step in both directions.
• Tasks deleted in Google Tasks are unlinked locally rather than destroyed.

How it works

The script polls the Google Tasks API on a timer, compares what it finds against the local Markdown file and the previous synchronisation snapshot, and writes the differences to whichever side is out of date. It uses the https://www.googleapis.com/auth/tasks scope, which is the narrowest scope that permits both reading and completing tasks.

Where the data goes

Nowhere except the user's own machine. There is no server component, no analytics, no third party, and no account system. Task data is written to local files and never leaves the device except when the script talks to Google's own API. See the privacy policy for the full detail.