Todoist Board

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

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 and 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.

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

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.
• 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.

Setup

Todoist Board requires Obsidian 1.8.7 or newer.

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.

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

Community release assets should match the version in manifest.json and include main.js, manifest.json, and styles.css.

Screenshots