Another Simple Todoist Sync

Create, edit, and delete tasks from within Obsidian.md to your Todoist.

[!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.

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

1. Open Obsidian's Community plugins tab, within the Settings window
2. Click Browse and search for Another Todoist Sync Plugin
3. Back to Community plugins, find the Installed Plugins section and activate the Another Todoist Sync Plugin

[!NOTE] You can update the plugin following the same procedure, clicking Update instead of Install

Manually

1. Download the latest release of the plugin from the Releases page.
2. Extract the downloaded zip file and copy the entire folder to your Obsidian plugins directory.
3. Enable the plugin in the Obsidian settings.

Configuration

1. Open Obsidian's Settings window
2. Select the Community plugins tab on the left
3. Under Installed plugins, click the gear icon next to the Another Simple Todoist Sync plugin
4. Enter your Todoist API token

Settings

1. 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.
2. Default project New tasks will be added to the default project, and you can change the default project in the settings.
3. Sync Comments By default, comments on tasks are added below your task on Obsidian. With this enabled, it won't sync comments.
4. Custom Sync Tag By default, sync new task with #tdsync, but you can change to #todoist
5. Alternative Keywords When enabled, accept new keywords for date, due time and duration (@,$ and &).

Usage

Task format

Import a task from a Todoist link

Enable the Import task from Todoist link option under Experimental features in settings. Then use the command palette (Import task from Todoist link) to paste any Todoist task URL, preview the task, and insert it into the current note already formatted for bidirectional sync.

Supported URL formats:

• https://app.todoist.com/app/task/TASK_ID
• https://app.todoist.com/app/task/task-name-TASK_ID (slugged URLs)
• https://app.todoist.com/app/project/PROJECT_ID/task/TASK_ID
• todoist://task?id=TASK_ID (app URI)

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.

Contributing & AI-assisted development

This repository includes a CLAUDE.md file that documents the architecture, data flow, key classes, and common gotchas for AI tools (Claude, Copilot, Cursor, etc.). If you are using an AI assistant to review or contribute to this repo, point it at that file first.

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 find a bug or have a feature request, please open an issue. Pull requests are also appreciated.

Prerequisites

• Node.js (v18+)
• A local Obsidian vault for manual testing

Setup

git clone https://github.com/eudennis/ultimate-todoist-sync-for-obsidian-experiment.git
cd ultimate-todoist-sync-for-obsidian-experiment
npm install

npm Scripts

Testing

Automated tests (Vitest)

npm test               # run the unit-test suite once
npm run test:watch     # re-run on change during development
npm run test:coverage  # run with a coverage report

Tests live in tests/ and cover the plugin's pure logic — markdown task parsing (taskParser), the in-memory cache (cacheOperation), the Todoist-link import modal (importTaskModal), and Todoist API payload assembly (todoistAPI). Obsidian and the Todoist SDK are mocked under tests/__mocks__/, so the suite needs no vault or network access. CI runs npm test on every pull request — please keep it green and add tests when you touch parsing, cache, import, or API logic.

Manual testing in Obsidian

Sync behaviour, file edits, and the settings UI can only be exercised inside Obsidian.

Option A — iterate quickly with dev (watch mode)

1. Run npm run dev to start the watcher.
2. Copy main.js, manifest.json, and styles.css into your vault's plugin directory:

   <vault>/.obsidian/plugins/another-simple-todoist-sync/
   

3. In Obsidian, run Reload app without saving (or fully restart Obsidian) to load the new build.
4. Enable Debug mode in the plugin's settings to get verbose console output (Ctrl+Shift+I opens the developer console).
5. Exercise the feature you changed and check the console for errors.

Repeat steps 1–5 after each code change (the watcher rebuilds main.js automatically; you still need to reload Obsidian).

Option B — production build with build-local

Point your Obsidian vault's plugin directory at LocalBuild/another-simple-todoist-sync/ once, then run:

npm run build-local

Each run type-checks, builds a production bundle, bumps a build number in the local manifest, and copies main.js and styles.css into LocalBuild/another-simple-todoist-sync/. Reload Obsidian to pick up the new build. The source manifest.json is not modified.

License

This plugin is released under the GNU GPLv3 License.