Another Simple Todoist Sync
eudennis3k downloadsSimple plugin to sync with Todoist. Fork from Ultimate Todoist Sync plugin.
- Overview
- Scorecard
- Updates33
Create, edit, and delete tasks from within Obsidian.md to your Todoist.
[!CAUTION] In early April 2025, this plugin was no longer working due to changes on the Todoist API. Check this comment for more details. Feel free to open bug reports.
[!WARNING] This is a fork from the Ultimate Todoist Sync plugin for Obsidian. I consider this as a beta, but I have been using for quite some time without issues. Feel free to contribute opening bug reports if you find anything.
Some features works only Todoist -> Obsidian, others by-directional. Find more details on the feature table below.
Table of detailed features supported
| Feature | from Obsidian to Todoist | from Todoist to Obsidian |
|---|---|---|
| Add task | ✅ | 🔜 |
| Delete task | ✅ | 🔜 |
| Modify task content | ✅ | ✅ |
| Modify task due date | ✅ | ✅ |
| Modify task due time | ✅ | 🔜 |
| Modify task description | 🔜 | 🔜 |
| Modify task labels/tags | ✅ | 🔜 |
| Mark task as completed | ✅ | ✅ |
| Mark task as uncompleted | ✅ | ✅ |
| Modify project | 🔜 | 🔜 |
| Modify section | 🔜 | 🔜 |
| Modify priority [1] | ✅ | 🔜 |
| Add reminder | ✅ | ✅ |
| Add duration | ✅ | 🔜 |
| Move tasks between files | 🔜 | 🔜 |
| Added-at date | 🔜 | 🔜 |
| Completed-at date | 🔜 | 🔜 |
| Task notes [2] | 🔜 | ✅ |
| Optional app link | ✅ | ✅ |
| Assign project to task | ✅ | 🔜 |
| Manage Deadline Date | ✅ | 🔜 |
- [1] Task priority only support one-way synchronization
- [2] Task notes/comments only support one-way synchronization from Todoist to Obsidian.
Installation
[!WARNING] The plugin will require the Todoist API token, which can be found on your
Settings > Integrations > Developer(direct link here). Note that some features will work for Todoist paid users.
From within Obsidian
- Open Obsidian's
Community pluginstab, within theSettingswindow - Click
Browseand search forAnother Todoist Sync Plugin - Back to
Community plugins, find theInstalled Pluginssection and activate theAnother Todoist Sync Plugin
[!NOTE] You can update the plugin following the same procedure, clicking Update instead of Install
Manually
- Download the latest release of the plugin from the Releases page.
- Extract the downloaded zip file and copy the entire folder to your Obsidian plugins directory.
- Enable the plugin in the Obsidian settings.
Configuration
- Open Obsidian's
Settingswindow - Select the
Community pluginstab on the left - Under
Installed plugins, click the gear icon next to theAnother Simple Todoist Syncplugin - Enter your Todoist API token
Settings
- Automatic synchronization interval time The time interval for automatic synchronization is set to 300 seconds by default, which means it runs every 5 minutes. You can modify it yourself.
- Default project New tasks will be added to the default project, and you can change the default project in the settings.
- Sync Comments By default, comments on tasks are added below your task on Obsidian. With this enabled, it won't sync comments.
- Custom Sync Tag
By default, sync new task with
#tdsync, but you can change to#todoist - Alternative Keywords When enabled, accept new keywords for date, due time and duration (@,$ and &).
Usage
Task format
| Syntax | Description | Example |
|---|---|---|
| #tdsync | Tasks marked with #tdsync[4] will be added to Todoist. If you have enabled Full Vault Sync, #tdsync will be added automatically. |
- [ ] task #tdsync |
| 📅YYYY-MM-DD | The date format is 📅YYYY-MM-DD, indicating the due date of a task. | - [ ] task content 📅2025-02-05 #todoist [1] |
| #tag | Note that all tags without a project of the same name are treated as normal tags | - [ ] task #tagA #tagB #tagC #todoist |
!!<number> |
The priority of the task between 1 and 4. [2] | - [ ] task !!1 #todoist |
| ⏰HH:MM | This sets the time of the task. If none is given, the default is 08:00 | - [ ] task ⏰23:59[3] |
| ⏳MMmin | This sets the duration of the task | - [ ] task ⏳30min[[5]] |
| /// | This adds the task to a section with | - [ ] task ///section_name[7] |
| #project #tag | First hashtag assign to a project with the same name | -[ ] task #project #tag1 #tag2 [8] |
| %%[p::ProjectName]%% | Assign task to project with hidden field | %%[p::ProjectName]%% [9] |
| {{YYYY-MM-DD}} | Assign a deadline date to a task | {{YYYY-MM-DD}} [10] |
Usage footnotes
- [1] Supports the following characters/emojis: 📅, 📆, 🗓, 🗓️, @ [6]
- [2] It's follow the same pattern of p1, p2, p3 and p4, p1 being the highest priority.
- [3] Supports the following characters/emojis: ⏰, ⏲, $ [6]
- [4] On the original plugin, this tag was
#todoist, but on this fork was changed to avoid conflicts. - [5] Supports the following characters/emojis: ⏳, & [6]
- [6] Alternative characters are enabled via "Alternative Keywords" on plugin settings page
- [7] If the section if removed from the task content, it won't update in Todoist (yet)
- [8] First tag will be used for project, but will also create a tag with the same name.
- [9] Project name is case-sensitive.
- [10] It supports YY-MM-DD, and if you use MM-DD default to the current YY
Set a default project for each file separately
The default project in the setting applies to all files. You can set a separate default project for each file using the comand Set default project for Todoist task in the current file from the command menu.
Tips
List your Todoist tasks within Obsidian
You can list all synchronized tasks from your Obsidian Vault using the Obsidian DataView plugin. If you create a view using the following code:
```dataview
task
where !completed and contains(tags, "#tdsync")
```
Expose tasks meta data
If you have the Obsidian DataView plugin you will be able to see the task ID on your tasks within Obsidian.
Disclaimer
This plugin is for learning purposes only. The author and contributors makes no representations or warranties of any kind, express or implied, about the accuracy, completeness, or usefulness of this plugin and shall not be liable for any losses or damages resulting from the use of this plugin.
The author shall not be responsible for any loss or damage, including but not limited to data loss, system crashes, computer damage, or any other form of loss arising from software problems or errors. Users assume all risks and are solely responsible for any consequences resulting from the use of this product.
By using this plugin, you agree to be bound by all the terms of this disclaimer. If you have any questions, please contact the author.
Contributing
Contributions are welcome! If you'd like to contribute to the plugin, please feel free to submit a pull request.
License
This plugin is released under the GNU GPLv3 License.