Todoist CLI

Use Todoist without leaving the command line. Add tasks, check what is due, and keep projects moving from the terminal. Official, open source, and ready for AI agents.

View on GitHub

$ npm i -g @doist/todoist-cli $ td auth login✓ Opened browser for Todoist authentication✓ Credentials saved to secure storage $ td skill install codex✓ Installed codex skill $ td today --accessibleToday (1)  Draft launch notes  id:8Jx4mVr72kPn3QwB  p4  due:today  Inbox $

Start using Todoist CLI

Install the CLI, sign in with Todoist, and add the agent skill you need before you settle into the longer workflow.

Step 1

Install Todoist CLI

npm i -g @doist/todoist-cli

Install the npm package to start using `td` in your terminal.
Step 2

Authenticate once

td auth login

Open the browser flow and connect your Todoist account.
Step 3

Add an agent skill

td skill install

Choose the agent you use and install the maintained skill.

One Todoist list for you and your agent

Capture tasks, check what is due, connect an agent, and open the task you need without scattering work across tools.

Capture work before it disappears Turn a quick thought or something your agent found into a real task with dates, projects, and labels.

$ td add "Send expense report tomorrow #Work"Created: Send expense reportDue: tomorrowID: 6gQxJWp6x8G75XvW $ td add "Call mom on Friday"Created: Call momDue: next FridayID: 6gQxJR6R886GJ6V4

Review today without leaving the terminal Check what is due now, what is overdue, and what still needs attention before you switch context.

$ td today --accessibleToday (1)  Create todoist-cli landing page  id:8Jx4mVr72kPn3QwB  p4  due:today  Work $ td task list --project "Work"  Create todoist-cli landing page  id:8Jx4mVr72kPn3QwB  p4  today  Work $ td task complete "Create todoist-cli landing page"Completed: Create todoist-cli landing page (id:8Jx4mVr72kPn3QwB)

Connect the agent you already use Install a maintained skill for Codex, Claude Code, Cursor, Gemini, and more instead of stitching together your own setup.

$ td task list --project "Work" --json[  {    "id": "8Jx4mVr72kPn3QwB",    "content": "Draft launch notes",    "projectId": "work"  },  {    "id": "6gQxJR6R886GJ6V4",    "content": "Review launch checklist",    "projectId": "work"  }] $ td skill install claude-code✓ Installed claude-code skill

Inspect the exact task you need Jump back into the right task by name when your agent or your terminal session needs more context.
$ td task view "Draft launch notes"Draft launch notes ID: 8Jx4mVr72kPn3QwBPriority: p4Project: WorkDue: today

$ td add "Send expense report tomorrow #Work"Created: Send expense reportDue: tomorrowID: 6gQxJWp6x8G75XvW $ td add "Call mom on Friday"Created: Call momDue: next FridayID: 6gQxJR6R886GJ6V4 $

$ td today --accessibleToday (1)  Create todoist-cli landing page  id:8Jx4mVr72kPn3QwB  p4  due:today  Work $ td task list --project "Work"  Create todoist-cli landing page  id:8Jx4mVr72kPn3QwB  p4  today  Work $ td task complete "Create todoist-cli landing page"Completed: Create todoist-cli landing page (id:8Jx4mVr72kPn3QwB) $

$ td task list --project "Work" --json[  {    "id": "8Jx4mVr72kPn3QwB",    "content": "Draft launch notes",    "projectId": "work"  },  {    "id": "6gQxJR6R886GJ6V4",    "content": "Review launch checklist",    "projectId": "work"  }] $ td skill install claude-code✓ Installed claude-code skill $

$ td task view "Draft launch notes"Draft launch notes ID:       8Jx4mVr72kPn3QwBPriority: p4Project:  WorkDue:      today $

Explore the source, releases, and API

Todoist CLI is an official open-source tool. Read the source, check the latest release, or pair it with the Todoist developer platform when you need deeper integrations.

Todoist CLI

Start using Todoist CLI

Install Todoist CLI

Authenticate once

Add an agent skill

One Todoist list for you and your agent

Explore the source, releases, and API

npm package

GitHub repository

Release notes

Developer API

Install `td` and give your agent a real task list

We respect your privacy