Todoist Board

Todoist Board is an Obsidian plugin that displays Todoist tasks as interactive boards in the sidebar or directly inside notes.

Features

• Sidebar board for quickly reviewing and managing Todoist tasks.
• Inline todoist-board code blocks for embedding filtered task lists in notes.
• Todoist filter support, including project, priority, date, and custom filter queries.
• Task actions for adding, editing, completing, deleting, scheduling, deferring, moving, and changing priority.
• Clickable Obsidian wikilinks in task titles and descriptions, with automatic Obsidian URI conversion when saving either field to Todoist.
• Command palette capture with Todoist Board: Add Task and recurring schedules in the task sheet's Repeats field.
• Todoist Board: Add task linked to active note opens a new task with a wikilink to the current note in its description.
• Parent and subtask display with collapse controls.
• Sorting, compact mode, hidden tasks, manual order, polling refresh, and cached offline display.
• Mobile support is enabled with isDesktopOnly: false.

NEW in 2.4

🆕 Use [[ to link your Obsidian notes in the task's title or description. Creates a hyperlink in Todoist that opens back to Obsidian.

Screenshots

Setup

Todoist Board requires Obsidian 1.8.7 or newer. Obsidian 1.11.4 or newer is recommended for Secret Storage support.

On Obsidian 1.13.0 or newer, plugin settings are also available in Obsidian's settings search.

1. Install the plugin in Obsidian.
2. Open Obsidian settings and go to Todoist Board.
3. Paste a Todoist personal API token.
4. Choose the filters you want available in the sidebar board.
5. Open the command palette and run Open Todoist Board.

You can create a Todoist personal API token from Todoist account settings. Existing plugin-data tokens are migrated to Obsidian Secret Storage automatically when Secret Storage is available.

Use Repeats when adding or editing a task for schedules such as every day, every Monday at 9am, or every! 2 weeks. A selected date starts a new repeat schedule from that date; an explicit start date in the repeat text takes precedence. Changing only the date of an existing repeating task moves its next occurrence while preserving the schedule. Clear Repeats to make the task a one-time task.

Use [[Note Name]] or [[Note Name|display text]] in task titles and descriptions to open notes from the board. Heading and block links work too. When you create or edit a task, wikilinks in its title and description are sent to Todoist as Markdown links such as [Note Name](obsidian://open?vault=My%20vault&file=Notes%2FNote%20Name.md). These links include the current vault name and the resolved note path; use the same vault name on your other devices. The task sheet displays these links as readable wikilinks when you reopen it. Code examples, escaped wikilinks, embeds, and existing Markdown links are preserved. Existing tasks are converted when saved; fetching tasks does not rewrite them in Todoist.

In the task sheet, type [[ in the task name or description to search vault notes by name, folder path, or frontmatter alias. Use the arrow keys and Enter or Tab to insert a link, or click/tap a result. Escape dismisses suggestions while keeping the task sheet open. Folder paths distinguish notes with the same name, and selecting an alias inserts [[Note|Alias]].

Completed wikilinks to existing notes use your theme's link colour in the task sheet. Links to missing notes use muted text with a dotted underline; the field's tooltip and screen-reader description identify the missing notes. This updates as you type and when notes are created, renamed, or deleted.

Inline Boards

Add a code block to any note:

```todoist-board
filter: today
```

Useful filter examples:

Todoist's filter syntax is documented in the Todoist help center.

Mobile Notes

Todoist Board avoids desktop-only Electron, Node, and filesystem APIs. Network requests use Obsidian's requestUrl API so the plugin can run on desktop and mobile. Mobile layouts are designed for touch use, including task sheets and long-press interactions.

Troubleshooting

• If no tasks appear, confirm that the Todoist API token is present and valid.
• If a filter looks empty, test the same query in Todoist and check project names, labels, dates, and priority syntax.
• If Todoist is unavailable, the plugin may show cached tasks until the next successful sync.
• If inline boards do not update, switch notes or run a manual sync from the sidebar board.
• If mobile behavior feels off, update Obsidian and the plugin, then reload the vault.

Development

npm install
npm run typecheck
npm run lint:obsidian
npm test
npm run build
npm audit

Run all release checks with:

npm run verify

Disclosures

• Requires a Todoist account and a Todoist personal API token.
• Connects to the Todoist REST and Sync APIs to fetch, create, update, schedule, move, and complete tasks.
• Stores the Todoist API token with Obsidian Secret Storage when available, falling back to plugin data storage on older Obsidian versions.
• Stores non-secret plugin preferences locally with Obsidian's plugin data storage.
• Caches task snapshots, project metadata, label metadata, hidden-task state, sort mode, compact mode, and manual order locally for responsiveness and offline display.
• Does not collect analytics, use telemetry, or send data to any service other than Todoist.
• Includes an optional funding link in the plugin settings and manifest.
• External links to Todoist help, Obsidian documentation, GitHub, and Ko-fi open only when clicked.
• The settings Copy button writes the example todoist-board block to the clipboard when clicked. The plugin does not read clipboard contents.

This plugin is not affiliated with, endorsed by, or sponsored by Todoist.