Skip to content
All tools

todoist_complete_task

Todoist · macOS · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Mark a Todoist task complete (closes it). Pass the task_id from todoist_list_tasks. Called without confirm it returns a preview and changes nothing; pass confirm=true to complete.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to send; without it nothing is sent and the call returns a preview of every field.",
      "type": "boolean"
    },
    "task_id": {
      "description": "The task id to complete",
      "type": "string"
    }
  },
  "required": [
    "task_id"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "task_id": "demo-task-001"
}

Windows

Purpose

Mark a Todoist task complete (closes it). Pass the task_id from todoist_list_tasks. Requires confirm=true to complete it — without it, returns a preview.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to complete the task. Without it, returns a preview.",
      "type": "boolean"
    },
    "task_id": {
      "description": "The task id to complete",
      "type": "string"
    }
  },
  "required": [
    "task_id"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "task_id": "demo-task-001"
}