Setup

There are a few steps to get up and running with this plugin.

1. Install plugin

First we need to install the plugin. You can follow this handy link to open the plugin's page in Obsidian and install it.

If you prefer to do it manually:

1. Open the settings in Obsidian
2. Select 'Community Plugins' in the sidebar
3. If necessary, turn on community plugins. Make sure you are comfortable with the warnings given to you on this page
4. Select 'Browse' and search for "Todoist Sync"
5. Install the plugin

2. Setup API token

Once the plugin is installed, you'll need to enable and do some initial setup.

1. Enable the plugin from Obsidian's setting page
2. You should get a popup asking you to provide your API token.
3. Paste your API token into the prompt
4. The prompt will verify that the token provided is valid and will present you with a checkmark if it is
5. Select 'Submit' to complete the setup

Note that this token is stored in its own file inside your vault. It can be found at .obsidian/todoist-token. If you synchronize your vault, you may choose to explicit ignore this file to avoid the API token leaving your machine. If you choose to do this, you must perform this setup on each device you access your vault on.

What's next?

Once you've set up the plugin you can explore adding query blocks, look at how to add tasks from Obsidian, or explore the plugin configuration.