Todoist
@mgreten/todoistv2026.07.29.1
01README
Todoist task management integration for swamp — task CRUD and moves, project and task-comment sync, filter-based sync, and natural language due dates via Todoist API v1.
02Release Notes
Add safe fan-out task moves, subtask creation support, stable create request IDs, mutation connectivity preflight, and documented label clearing.
03Models
@mgreten/todoistv2026.07.29.1todoist.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiToken | string | Todoist API token |
| defaultProjectId? | string | Default project ID used when no projectId is specified |
fn syncTasks(filter?: string)
Fetch active tasks and write them as resources. Accepts Todoist filter syntax.
| Argument | Type | Description |
|---|---|---|
| filter? | string | Todoist filter query; omit to fetch all active tasks |
fn syncProjects()
Fetch all Todoist projects and sync them as resources
fn syncTaskComments()
Fetch every comment for one Todoist task and write normalized comment resources
fn createTaskComment(content: string)
Create a comment on a Todoist task and write its normalized resource
| Argument | Type | Description |
|---|---|---|
| content | string | Comment text |
fn createTask(content: string, description?: string, projectId?: string, sectionId?: string, labels?: string, priority?: number, dueString?: string)
Create a new Todoist task
| Argument | Type | Description |
|---|---|---|
| content | string | Task content (title) |
| description? | string | Task description (Markdown) |
| projectId? | string | Project ID (defaults to defaultProjectId) |
| sectionId? | string | Section ID within the project |
| labels? | string | Comma-separated label names |
| priority? | number | Priority: 1=normal, 2=medium, 3=high, 4=urgent |
| dueString? | string | Natural language due date |
fn completeTask()
Mark a task as completed
fn updateTask(content?: string, description?: string, labels?: string, priority?: number, dueString?: string)
Update fields on an existing task
| Argument | Type | Description |
|---|---|---|
| content? | string | New task content |
| description? | string | New description |
| labels? | string | Comma-separated label names; replaces existing labels, and an empty string clears all labels |
| priority? | number | New priority |
| dueString? | string | New due date |
fn moveTasks(moves: array)
Move one or more existing task trees to a project, section, or parent task
| Argument | Type | Description |
|---|---|---|
| moves | array | Task moves processed in order within one model execution |
fn deleteTask()
Permanently delete a task
Resources
task(infinite)— A Todoist task with normalized metadata
project(infinite)— A Todoist project
comment(infinite)— A Todoist task comment with normalized metadata
04Previous Versions
2026.07.28.1
Add parentId support to createTask so callers can create Todoist subtasks and preserve the parent relationship in stored task resources.
2026.07.27.3
2026.07.27.2
2026.07.27.1
Modified 1 models
2026.07.24.1
2026.07.23.1
Complete the migration to Todoist API v1: correct filtered task queries and request fields, cursor pagination, recurring-task completion, nullable timestamps, project URLs, upgrade metadata, and published documentation.
2026.07.16.1
Rebuild against swamp CLI 20260716
2026.06.27.1
Added 1, removed 1 models
2026.06.08.2
2026.06.08.1
05Stats
A
100 / 100
Downloads
8
Archive size
22.2 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
06Platforms