FAQ - Obsidian-Tasks-Sync/obsidian-tasks-sync GitHub Wiki
Frequently Asked Questions (FAQ)
This page answers common questions related to installation, authentication, usage, and platform integration of Obsidian Tasks Sync.
General
Q: What does this plugin do?
A: Obsidian Tasks Sync lets you create, edit, and sync tasks between Obsidian markdown notes and external task services like Google Tasks or Todoist.
Q: Is internet access required to use this plugin?
A: Yes, syncing tasks with external platforms requires internet access and valid OAuth authentication.
Installation & Setup
Q: How do I install the plugin?
A: See the Installation Guide for step-by-step instructions. You’ll need to copy the plugin to .obsidian/plugins/, install dependencies with pnpm, and activate it inside Obsidian.
Q: I'm seeing a "Failed to authenticate" error. What should I do?
A: Ensure your client ID/secret are correct and registered in the correct redirect URI. If needed, reset credentials in the plugin settings and try again.
Google Tasks
Q: Why do I have to create my own Google Cloud credentials?
A: To avoid centralized quota limits and protect your data privacy. Each user registers their own OAuth client to manage their own access.
Q: What is the gtask: syntax in my markdown?
A: It's a unique ID used by the plugin to link local tasks with Google Tasks. Do not edit this ID manually.
Todoist
Q: Can I sync tasks with labels or projects in Todoist?
A: Yes, project and label mapping is supported via the settings panel in the Todoist integration.
Q: Does Todoist support subtasks?
A: The API supports parent task relationships, but full subtask handling inside Obsidian is planned for future updates.
Sync & Behavior
Q: Are tasks synced in real time?
A: Yes, currently syncing every 60 seconds.
Q: What happens if I delete a task in Obsidian or in Google/Todoist?
A: Deletion is not yet synchronized. Currently, only creation, update, and status toggling are synced.
Q: Can I use both Google Tasks and Todoist at the same time?
A: Not currently. Only one provider can be active at a time per plugin instance.
Development & Contributions
Q: Can I add a new task platform?
A: Yes! See the Contributing Guide for implementation steps.
Q: Where can I report bugs or request features?
A: Please open an issue on the GitHub Issue Tracker.
Last updated: 2025-06