todoist-tasks

Todoist Task Operations

All task operations delegate to the todoist-agent subagent via natural language.

Batch-First Delegation

Collect all items from the user's request before delegating. One delegation per operation type:

• Multiple creates → list all tasks in one delegation
• Multiple completions → list all task names/IDs in one delegation
• Never call the agent separately for each item in a batch

Delegation Conventions

When describing tasks to the agent, use these formats:

• Priority: p1 (highest) through p4 (lowest/default)
• Project: use the project name as the user said it
• Due dates: pass through natural language ("tomorrow", "next Friday", "March 15")
• Labels: prefix with @ if the user doesn't

Examples

• "Create a task 'Review PR #42' in Work, p2 priority, due tomorrow"
• "Complete these tasks: Deploy hotfix, Update docs, Close issue #99"
• "Show tasks due today"
• "Create 3 tasks in Personal: Buy groceries (due today), Call dentist (due Monday, p2), Renew subscription (due March 1)"

Error Recovery

If the agent reports a project, label, or section "not found":

1. Invoke todoist:todoist-sync to refresh structure
2. Retry the original operation once
3. If still failing, report to the user — the entity may not exist