todoist-task-management

id	todoist-task-management
name	Todoist Task Management
description	Add, list, and close tasks; list projects
role	product
requiredTools	[{"type":"mcpService","serviceType":"todoist"}]

Todoist Task Management

When managing tasks in Todoist:

• Use todoist_add_task (tool name may have a suffix if multiple Todoist servers exist) to create tasks with natural language due dates.
• Use todoist_get_tasks to list active tasks using Todoist filters (e.g. by project, date, label).
• Use todoist_close_task to complete a task by ID.
• Use todoist_get_projects to list projects and resolve project IDs when the user refers to a project by name.
• Todoist OAuth does not provide refresh tokens; suggest reconnecting if the token is revoked.

Step-by-step instructions

1. For "add task X": call todoist_add_task with content and optional due string (natural language, e.g. "tomorrow", "next Monday"); optionally specify project_id from todoist_get_projects if the user named a project.
2. For "list my tasks" or "tasks for project Y": call todoist_get_tasks with filter string and/or project_id; summarize task content, due date, and ID.
3. For "complete task Z": call todoist_close_task with the task ID; confirm completion to the user.
4. When project is ambiguous: call todoist_get_projects and list names/IDs so the user can choose, or infer from context.
5. Keep summaries concise (task content, due, ID); avoid dumping full payloads unless asked.

Examples of inputs and outputs

• Input: "Add a task: Review PR by tomorrow."
  Output: Call todoist_add_task with content "Review PR" and due "tomorrow"; confirm "Added task: Review PR (due tomorrow)."

• Input: "What tasks are due this week?"
  Output: List of tasks from todoist_get_tasks with an appropriate filter (e.g. "due: this week"); summarize content, due date, and ID per task.

• Input: "Mark task 12345 as done."
  Output: Call todoist_close_task with id 12345; confirm "Task 12345 completed."

Common edge cases

• Project not found: Use todoist_get_projects to list projects; say "Project [name] not found" or suggest the closest match.
• Task not found: Say "Task [id] not found" and suggest listing tasks to get valid IDs.
• Natural language due: todoist_add_task accepts natural language (e.g. "tomorrow", "next Friday"); use it when the user gives a relative date.
• API/OAuth error: Report that Todoist returned an error; mention that reconnecting may be needed if the token was revoked.

Tool usage for specific purposes

• todoist_add_task: Use to create a task; include content and optional due (natural language) and project_id.
• todoist_get_tasks: Use to list active tasks; use filter and/or project_id to scope.
• todoist_close_task: Use to complete a task by ID.
• todoist_get_projects: Use to list projects and resolve project_id when the user refers to a project by name.