Procedural guidance for Todoist task management via the td CLI tool.
Works with
Supports full CRUD operations on tasks, projects, sections, labels, and comments with natural language quick-add parsing (e.g., td add \"Buy milk tomorrow p1 #Shopping\" )
Requires user confirmation before destructive actions (delete, complete, update, archive); read-only operations execute directly
Provides filtering by project, label, priority, due date, assignee, and custom Todoist queries; output as JSON, newlin
AI-first code editor with Composer
Before installing skills in Cursor, ensure your development environment meets these requirements:
node --versiontodoist-apiExecute the skills CLI command in your project's root directory to begin installation:
Fetches todoist-api from intellectronica/agent-skills and configures it for Cursor.
The CLI shows a list of agents. Use arrow keys and space to select Cursor:
Confirm successful installation by checking the skill directory location:
Restart Cursor to activate todoist-api. Access via /todoist-api in your agent's command palette.
We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.
Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.
Submit your Claude Code skill and start earning
Automate repetitive workflows and reduce manual effort
Example
Generate reports, summarize documents, draft communications
Save 3-5 hours per week on routine tasks
Learn new skills, understand complex topics, get expert guidance
Example
Explain concepts, provide examples, suggest learning resources
Accelerate learning and skill development by 2x
Enhance output quality through reviews, suggestions, and refinements
Example
Review drafts, suggest improvements, catch errors
Improve work quality by 30-40% with less effort
0
total installs
0
this week
236
GitHub stars
0
upvotes
Run in your terminal
0
installs
0
this week
236
stars
This skill provides procedural guidance for working with Todoist using the td CLI tool.
The td CLI must be installed and authenticated. Verify with:
td auth status
If td is not installed or not authenticated:
npm install -g @doist/todoist-clitd auth login to authenticate via OAuthFor machine-readable output, use these flags:
--json - Output as JSON array--ndjson - Output as newline-delimited JSON (one object per line)--full - Include all fields in JSON output (default shows essential fields only)Before executing any destructive action, always ask the user for confirmation using AskUserQuestion or similar tool. A single confirmation suffices for a logical group of related actions.
Destructive actions include:
Read-only operations do not require confirmation.
| Command | Description |
|---|---|
td add "text" |
Quick add with natural language parsing |
td today |
Tasks due today and overdue |
td upcoming [days] |
Tasks due in next N days (default: 7) |
td inbox |
Tasks in Inbox |
td completed |
Recently completed tasks |
td add "Buy milk tomorrow p1 #Shopping"
td add "Call dentist every monday @health"
td add "Review PR #Work /Code Review"
The quick add parser supports:
tomorrow, next monday, Jan 15p1 (urgent) through p4 (normal)#ProjectName/SectionName@label1 @label2td task list [options]
Filters:
--project <name> - Filter by project name or id:xxx--label <name> - Filter by label (comma-separated for multiple)--priority <p1-p4> - Filter by priority--due <date> - Filter by due date (today, overdue, or YYYY-MM-DD)--filter <query> - Raw Todoist filter query--assignee <ref> - Filter by assignee (me or id:xxx)--workspace <name> - Filter to workspace--personal - Filter to personal projects onlyOutput:
td task list --json # JSON array
td task list --project "Work" --json # Filtered JSON
td task list --all --json # All tasks (no limit)
td task view <ref> # Human-readable
td task view <ref> --json # JSON output
The ref can be a task name, partial match, or id:xxx.
Quick add (natural language):
td add "Task text with #Project @label tomorrow p2"
Explicit flags:
td task add --content "Task text" \
--project "Work" \
--due "tomorrow" \
--priority p2 \
--labels "urgent,review" \
--description "Additional details"
Options:
--content <text> - Task content (required)--due <date> - Due date (natural language or YYYY-MM-DD)--deadline <date> - Deadline date (YYYY-MM-DD)--priority <p1-p4> - Priority level--project <name> - Project name or id:xxx--section <id> - Section ID--labels <a,b> - Comma-separated labels--parent <ref> - Parent task for subtask--description <text> - Task description--assignee <ref> - Assign to user (name, email, id:xxx, or "me")--duration <time> - Duration (e.g., 30m, 1h, 2h15m)td task update <ref> --content "New content" --due "next week"
Options:
--content <text> - New content--due <date> - New due date--deadline <date> - Deadline date--no-deadline - Remove deadline--priority <p1-p4> - New priority--labels <a,b> - Replace labels--description <text> - New description--assignee <ref> - Assign to user--unassign - Remove assignee--duration <time> - Durationtd task complete <ref>
td task uncomplete id:xxx
Note: Uncomplete requires the task ID (id:xxx format).
td task delete <ref>
td task move <ref> --project "New Project"
td task move <ref> --section <section-id>
td task move <ref> --parent <task-ref>
td task browse <ref>
td project list # Human-readable tree
td project list --json # JSON array
td project list --personal --json # Personal projects only
td project view <ref>
td project view <ref> --json
td project create --name "Project Name" \
--color "blue" \
--parent "Parent Project" \
--view-style board \
--favorite
Options:
--name <name> - Project name (required)--color <color> - Colour name--parent <ref> - Parent project for nesting--view-style <style> - "list" or "board"--favorite - Mark as favouritetd project update <ref> --name "New Name" --color "red"
td project archive <ref>
td project unarchive <ref>
td project delete <ref>
Note: Project must have no uncompleted tasks.
td project collaborators <ref>
td section list <project> # Human-readable
td section list <project> --json # JSON array
td section create --name "Section Name" --project "Project Name"
td section update <id> --name "New Name"
td section delete <id>
td label list # Human-readable
td label list --json # JSON array
td label create --name "label-name" --color "green" --favorite
td label update <ref> --name "new-name" --color "blue"
td label delete <name>
td comment list <task-ref> # Comments on task
td comment list <project-ref> --project # Comments on project
td comment add <task-ref> --content "Comment text"
td comment add <project-ref> --project --content "Comment text"
td comment update <id> --content "Updated text"
td comment delete <id>
td reminder list <task-ref>
td reminder add <task-ref> --due "tomorrow 9am"
td reminder delete <id>
td filter list --json
td filter show <filter-ref> --json
td filter create --name "My Filter" --query "today & p1"
td completed # Today's completed tasks
td completed --since 2024-01-01 # Since specific date
td completed --project "Work" --json # Filtered JSON output
td completed --all --json # All completed (no limit)
Options:
--since <date> - Start date (YYYY-MM-DD), default: today--until <date> - End date (YYYY-MM-DD), default: tomorrow--project <name> - Filter by projecttd activity # Recent activity
td stats # Productivity stats and karma
For large result sets, use --all to fetch everything, or handle pagination with cursors:
# First page
result=$(td task list --json --limit 50)
# If there's a next_cursor in the response, continue
cursor=$(echo "$result" | jq -r '.[-1].id // empty')
td task list --json --limit 50 --cursor "$cursor"
The <ref> parameter in commands accepts:
Prerequisites
Time Estimate
15-45 minutes depending on use case complexity
Steps
Common Pitfalls
✓ Do
✗ Don't
💡 Pro Tips
✓ Use when
Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.
✗ Avoid when
Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.
intellectronica/agent-skills
intellectronica/agent-skills
jwynia/agent-skills
mindrally/skills
kostja94/marketing-skills
github/awesome-copilot
Keeps context tight: todoist-api is the kind of skill you can hand to a new teammate without a long onboarding doc.
Solid pick for teams standardizing on skills: todoist-api is focused, and the summary matches what you get after install.
todoist-api reduced setup friction for our internal harness; good balance of opinion and flexibility.
Registry listing for todoist-api matched our evaluation — installs cleanly and behaves as described in the markdown.
todoist-api is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.
Useful defaults in todoist-api — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.
I recommend todoist-api for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
todoist-api fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
todoist-api reduced setup friction for our internal harness; good balance of opinion and flexibility.
todoist-api fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
showing 1-10 of 38