todoist
Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.
When & Why to Use This Skill
This Claude skill integrates Todoist's robust task management capabilities directly into your AI workflow. It enables users to seamlessly create, organize, and track tasks, projects, and reminders using natural language, significantly enhancing personal productivity and streamlining project coordination.
Use Cases
- Daily Planning: Quickly retrieve a list of today's tasks or overdue items to prioritize your workday effectively.
- Natural Language Task Capture: Instantly add new tasks with specific due dates (e.g., 'next Monday'), priority levels, and project assignments through simple conversational commands.
- Project Organization: Efficiently move tasks between projects, update task details, or mark items as complete without leaving the chat interface.
- Advanced Filtering and Search: Locate specific tasks or comments across multiple projects using powerful search queries and priority filters.
| name | todoist |
|---|---|
| description | Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity. |
| homepage | https://todoist.com |
| emoji | "✅" |
| bins | ["todoist"] |
| env | ["TODOIST_API_TOKEN"] |
Todoist CLI
CLI for Todoist task management, built on the official TypeScript SDK.
Installation
npm install -g todoist-ts-cli
Setup
- Get API token from https://todoist.com/app/settings/integrations/developer
- Either:
todoist auth <your-token> # or export TODOIST_API_TOKEN="your-token"
Commands
Tasks
todoist # Show today's tasks (default)
todoist today # Same as above
todoist tasks # List tasks (today + overdue)
todoist tasks --all # All tasks
todoist tasks -p "Work" # Tasks in project
todoist tasks -f "p1" # Filter query (priority 1)
todoist tasks --json
Add Tasks
todoist add "Buy groceries"
todoist add "Meeting" --due "tomorrow 10am"
todoist add "Review PR" --due "today" --priority 1 --project "Work"
todoist add "Call mom" -d "sunday" -l "family" # with label
Manage Tasks
todoist view <id> # View task details
todoist done <id> # Complete task
todoist reopen <id> # Reopen completed task
todoist update <id> --due "next week"
todoist move <id> -p "Personal"
todoist delete <id>
Search
todoist search "meeting"
Projects & Labels
todoist projects # List projects
todoist project-add "New Project"
todoist labels # List labels
todoist label-add "urgent"
Comments
todoist comments <task-id>
todoist comment <task-id> "Note about this task"
Usage Examples
User: "What do I have to do today?"
todoist today
User: "Add 'buy milk' to my tasks"
todoist add "Buy milk" --due "today"
User: "Remind me to call the dentist tomorrow"
todoist add "Call the dentist" --due "tomorrow"
User: "Mark the grocery task as done"
todoist search "grocery" # Find task ID
todoist done <id>
User: "What's on my work project?"
todoist tasks -p "Work"
User: "Show my high priority tasks"
todoist tasks -f "p1"
Filter Syntax
Todoist supports powerful filter queries:
p1,p2,p3,p4- Priority levelstoday,tomorrow,overdue@label- Tasks with label#project- Tasks in projectsearch: keyword- Search
Notes
- Task IDs are shown in task listings
- Due dates support natural language ("tomorrow", "next monday", "jan 15")
- Priority 1 is highest, 4 is lowest