Todoist
Connects to the Todoist REST API for managing tasks and projects. An agent can create, read, update, complete, and list tasks, and list projects.
Add to an agent node's tools array with _node_type: "tool-todoist". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
api_token | Yes (or token) | Todoist API token, sent as Authorization: Bearer <token>. |
token | Fallback | Used if api_token is not set. |
{
"name": "todoist",
"_node_type": "tool-todoist",
"api_token": "{{ secret.TODOIST_API_TOKEN }}"
}
Tools
todoist_create_task
Create a new task in Todoist.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | Yes | Task content/title |
description | string | No | Task description |
project_id | string | No | Project ID (default inbox) |
due_string | string | No | Due date in natural language (e.g. tomorrow, next monday) |
priority | number | No | Priority 1-4 (4=highest) |
labels | string | No | Comma-separated label names |
Returns: A confirmation message with the new task's ID, content and URL.
todoist_get_task
Get details of a Todoist task.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Task ID |
Returns: The raw JSON response for the task.
todoist_update_task
Update a Todoist task.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Task ID |
content | string | No | New task content |
description | string | No | New description |
due_string | string | No | New due date |
priority | number | No | New priority 1-4 |
Returns: A confirmation message that the task was updated.
todoist_close_task
Mark a Todoist task as complete.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Task ID to mark as complete |
Returns: A confirmation message that the task was marked complete.
todoist_list_tasks
List tasks in Todoist, optionally filtered.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | No | Filter by project ID |
label | string | No | Filter by label name |
filter | string | No | Todoist filter query (e.g. today, overdue) |
Returns: A count line followed by a newline-separated list of [id] content (due: ...) lines.
todoist_list_projects
List all Todoist projects.
No parameters.
Returns: A newline-separated list of [id] name lines.