Usage - Obsidian-Tasks-Sync/obsidian-tasks-sync GitHub Wiki

Usage Guide

Basic Workflow

Once the plugin is installed and authorized with Google Tasks, you can use it to manage tasks from either Obsidian or Google Tasks with real-time synchronization.

1. Writing a Task in Obsidian

Create tasks using standard markdown syntax with an optional Google Task identifier:

- [ ] Buy groceries
- [x] Finish report (gtask:abc123:def456)
  • [ ] indicates an incomplete task

  • [x] indicates a completed task

  • The (gtask:...) part is automatically added after syncing to Google Tasks and should not be edited manually

2. Sending Tasks to Google

  • Select the desired line(s) in your note

  • Open the Command Palette (Cmd+P or Ctrl+P)

  • Execute: Turn into Google Task

  • A Google Task will be created, and the gtask: ID will be appended

3. Syncing from Google to Obsidian

To update tasks from Google Tasks (status or content):

  • Click the Sync from Remote button shown next to a synced task

  • Or, run the command from the palette: Sync All Tasks

This will fetch the latest state from Google and update the markdown file.

Command Palette Shortcuts

Command Name Description
Turn into Google Task Creates a Google Task from selected text
Sync from Remote Updates local task from Google Task
Sync All Tasks Pulls all changes from Google Tasks

Tips

  • Do not manually change the gtask: ID — it may break sync

  • You can sync tasks in both directions anytime

  • Great for combining daily logs in Obsidian with mobile task management in Google

Example

# Today's Notes
  • Write project proposal
  • Prepare slides for meeting

Synced Tasks

  • Submit expense report (gtask:8c123ab9def)
  • Update resume (gtask:7e443kq9ccx)

To send “Write project proposal” to Google Tasks:

  • Select the line

  • Run Turn into Google Task

The plugin will handle task creation and syncing automatically.

⚠️ **GitHub.com Fallback** ⚠️