Todoist API

Manage tasks, projects, sections, labels, and comments with the Todoist REST API v2.

Official docs: https://developer.todoist.com/rest/v2

When to Use

Create, update, complete, and delete tasks
Organize tasks into projects and sections
Add labels and comments to tasks
List and filter tasks by project or label
Manage projects (create, update, delete)

Prerequisites

Go to vm0.ai Settings > Connectors and connect Todoist. vm0 will automatically inject the required TODOIST_TOKEN environment variable.

Important: When using $VAR in a command that pipes to another command, wrap the command containing $VAR in bash -c '...'. Due to a Claude Code bug, environment variables are silently cleared when pipes are used directly.

Core APIs

Get All Projects

bash -c 'curl -s "https://api.todoist.com/rest/v2/projects" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '.[] | {id, name, color, is_favorite}'

Docs: https://developer.todoist.com/rest/v2/#get-all-projects

Get Project

Replace <project-id> with the actual project ID:

bash -c 'curl -s "https://api.todoist.com/rest/v2/projects/<project-id>" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '{id, name, comment_count, color, is_shared, is_favorite, url}'

Create Project

Write to /tmp/todoist_request.json:

{
  "name": "My New Project"
}

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/projects" --header "Authorization: Bearer $TODOIST_TOKEN" --header "Content-Type: application/json" -d @/tmp/todoist_request.json' | jq '{id, name, url}'

Docs: https://developer.todoist.com/rest/v2/#create-a-new-project

Update Project

Replace <project-id> with the actual project ID.

Write to /tmp/todoist_request.json:

{
  "name": "Renamed Project",
  "color": "blue"
}

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/projects/<project-id>" --header "Authorization: Bearer $TODOIST_TOKEN" --header "Content-Type: application/json" -d @/tmp/todoist_request.json' | jq '{id, name, color}'

Delete Project

Replace <project-id> with the actual project ID:

bash -c 'curl -s -X DELETE "https://api.todoist.com/rest/v2/projects/<project-id>" --header "Authorization: Bearer $TODOIST_TOKEN" -w "\nHTTP Status: %{http_code}\n"'

A 204 response means success.

Get Active Tasks

bash -c 'curl -s "https://api.todoist.com/rest/v2/tasks" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '.[] | {id, content, description, project_id, priority, due: .due.date, labels}'

Docs: https://developer.todoist.com/rest/v2/#get-active-tasks

Get Active Tasks by Project

Replace <project-id> with the actual project ID:

bash -c 'curl -s "https://api.todoist.com/rest/v2/tasks?project_id=<project-id>" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '.[] | {id, content, priority, due: .due.date}'

Get Task

Replace <task-id> with the actual task ID:

bash -c 'curl -s "https://api.todoist.com/rest/v2/tasks/<task-id>" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '{id, content, description, project_id, section_id, priority, due, labels, url}'

Create Task

Write to /tmp/todoist_request.json:

{
  "content": "Buy groceries",
  "description": "Milk, eggs, bread",
  "project_id": "<project-id>",
  "priority": 3,
  "due_string": "tomorrow at 10am",
  "labels": ["errands"]
}

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/tasks" --header "Authorization: Bearer $TODOIST_TOKEN" --header "Content-Type: application/json" -d @/tmp/todoist_request.json' | jq '{id, content, due: .due.date, url}'

Docs: https://developer.todoist.com/rest/v2/#create-a-new-task

Update Task

Replace <task-id> with the actual task ID.

Write to /tmp/todoist_request.json:

{
  "content": "Buy groceries and snacks",
  "priority": 4
}

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/tasks/<task-id>" --header "Authorization: Bearer $TODOIST_TOKEN" --header "Content-Type: application/json" -d @/tmp/todoist_request.json' | jq '{id, content, priority}'

Complete Task

Replace <task-id> with the actual task ID:

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/tasks/<task-id>/close" --header "Authorization: Bearer $TODOIST_TOKEN" -w "\nHTTP Status: %{http_code}\n"'

A 204 response means success.

Docs: https://developer.todoist.com/rest/v2/#close-a-task

Reopen Task

Replace <task-id> with the actual task ID:

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/tasks/<task-id>/reopen" --header "Authorization: Bearer $TODOIST_TOKEN" -w "\nHTTP Status: %{http_code}\n"'

Delete Task

Replace <task-id> with the actual task ID:

bash -c 'curl -s -X DELETE "https://api.todoist.com/rest/v2/tasks/<task-id>" --header "Authorization: Bearer $TODOIST_TOKEN" -w "\nHTTP Status: %{http_code}\n"'

Get Sections

bash -c 'curl -s "https://api.todoist.com/rest/v2/sections" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '.[] | {id, name, project_id, order}'

Get Sections by Project

Replace <project-id> with the actual project ID:

bash -c 'curl -s "https://api.todoist.com/rest/v2/sections?project_id=<project-id>" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '.[] | {id, name, order}'

Create Section

Write to /tmp/todoist_request.json:

{
  "project_id": "<project-id>",
  "name": "Backlog"
}

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/sections" --header "Authorization: Bearer $TODOIST_TOKEN" --header "Content-Type: application/json" -d @/tmp/todoist_request.json' | jq '{id, name, project_id}'

Get Labels

bash -c 'curl -s "https://api.todoist.com/rest/v2/labels" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '.[] | {id, name, color, order, is_favorite}'

Create Label

Write to /tmp/todoist_request.json:

{
  "name": "urgent",
  "color": "red"
}

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/labels" --header "Authorization: Bearer $TODOIST_TOKEN" --header "Content-Type: application/json" -d @/tmp/todoist_request.json' | jq '{id, name, color}'

Get Comments for Task

Replace <task-id> with the actual task ID:

bash -c 'curl -s "https://api.todoist.com/rest/v2/comments?task_id=<task-id>" --header "Authorization: Bearer $TODOIST_TOKEN"' | jq '.[] | {id, content, posted_at}'

Create Comment

Write to /tmp/todoist_request.json:

{
  "task_id": "<task-id>",
  "content": "This task needs review before closing."
}

bash -c 'curl -s -X POST "https://api.todoist.com/rest/v2/comments" --header "Authorization: Bearer $TODOIST_TOKEN" --header "Content-Type: application/json" -d @/tmp/todoist_request.json' | jq '{id, content, posted_at}'

Guidelines

Priority values: 1 (normal) to 4 (urgent) — higher number = higher priority
Due strings: Todoist supports natural language like "tomorrow", "every monday", "Jan 15 at 3pm"
Rate limits: Standard rate limits apply; avoid rapid-fire requests
Task IDs: All IDs are strings; use values from list/create responses
Completed tasks: Use the /close endpoint, not delete, to mark tasks done