todoist_create_task

Instructions

Create one or more tasks in Todoist with full parameter support

Input Schema

Name	Required	Description
`assignee_id`	No	User ID to assign the task to (optional)
`content`	No	The content/title of the task (for single task creation)
`deadline_date`	No	Deadline date in YYYY-MM-DD format (optional)
`deadline_lang`	No	2-letter language code for deadline parsing (optional)
`description`	No	Detailed description of the task (optional)
`due_date`	No	Due date in YYYY-MM-DD format (optional)
`due_datetime`	No	Due date and time in RFC3339 format (optional)
`due_lang`	No	2-letter language code for due date parsing (optional)
`due_string`	No	Natural language due date like 'tomorrow', 'next Monday' (optional)
`duration`	No	The duration amount of the task (optional)
`duration_unit`	No	The duration unit ('minute' or 'day') (optional)
`labels`	No	Array of label names to apply to the task (optional)
`order`	No	Position in the project or parent task (optional)
`parent_id`	No	ID of the parent task for subtasks (optional)
`priority`	No	Task priority from 1 (normal) to 4 (urgent) (optional)
`project_id`	No	ID of the project to add the task to (optional)
`section_id`	No	ID of the section to add the task to (optional)
`tasks`	No	Array of tasks to create (for batch operations)

Input Schema (JSON Schema)

{
  "properties": {
    "assignee_id": {
      "description": "User ID to assign the task to (optional)",
      "type": "string"
    },
    "content": {
      "description": "The content/title of the task (for single task creation)",
      "type": "string"
    },
    "deadline_date": {
      "description": "Deadline date in YYYY-MM-DD format (optional)",
      "type": "string"
    },
    "deadline_lang": {
      "description": "2-letter language code for deadline parsing (optional)",
      "type": "string"
    },
    "description": {
      "description": "Detailed description of the task (optional)",
      "type": "string"
    },
    "due_date": {
      "description": "Due date in YYYY-MM-DD format (optional)",
      "type": "string"
    },
    "due_datetime": {
      "description": "Due date and time in RFC3339 format (optional)",
      "type": "string"
    },
    "due_lang": {
      "description": "2-letter language code for due date parsing (optional)",
      "type": "string"
    },
    "due_string": {
      "description": "Natural language due date like 'tomorrow', 'next Monday' (optional)",
      "type": "string"
    },
    "duration": {
      "description": "The duration amount of the task (optional)",
      "type": "number"
    },
    "duration_unit": {
      "description": "The duration unit ('minute' or 'day') (optional)",
      "enum": [
        "minute",
        "day"
      ],
      "type": "string"
    },
    "labels": {
      "description": "Array of label names to apply to the task (optional)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "order": {
      "description": "Position in the project or parent task (optional)",
      "type": "number"
    },
    "parent_id": {
      "description": "ID of the parent task for subtasks (optional)",
      "type": "string"
    },
    "priority": {
      "description": "Task priority from 1 (normal) to 4 (urgent) (optional)",
      "enum": [
        1,
        2,
        3,
        4
      ],
      "type": "number"
    },
    "project_id": {
      "description": "ID of the project to add the task to (optional)",
      "type": "string"
    },
    "section_id": {
      "description": "ID of the section to add the task to (optional)",
      "type": "string"
    },
    "tasks": {
      "description": "Array of tasks to create (for batch operations)",
      "items": {
        "properties": {
          "assignee_id": {
            "description": "User ID to assign the task to (optional)",
            "type": "string"
          },
          "content": {
            "description": "The content/title of the task (required)",
            "type": "string"
          },
          "deadline_date": {
            "description": "Deadline date in YYYY-MM-DD format (optional)",
            "type": "string"
          },
          "deadline_lang": {
            "description": "2-letter language code for deadline parsing (optional)",
            "type": "string"
          },
          "description": {
            "description": "Detailed description of the task (optional)",
            "type": "string"
          },
          "due_date": {
            "description": "Due date in YYYY-MM-DD format (optional)",
            "type": "string"
          },
          "due_datetime": {
            "description": "Due date and time in RFC3339 format (optional)",
            "type": "string"
          },
          "due_lang": {
            "description": "2-letter language code for due date parsing (optional)",
            "type": "string"
          },
          "due_string": {
            "description": "Natural language due date like 'tomorrow', 'next Monday' (optional)",
            "type": "string"
          },
          "duration": {
            "description": "The duration amount of the task (optional)",
            "type": "number"
          },
          "duration_unit": {
            "description": "The duration unit ('minute' or 'day') (optional)",
            "enum": [
              "minute",
              "day"
            ],
            "type": "string"
          },
          "labels": {
            "description": "Array of label names to apply to the task (optional)",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "order": {
            "description": "Position in the project or parent task (optional)",
            "type": "number"
          },
          "parent_id": {
            "description": "ID of the parent task for subtasks (optional)",
            "type": "string"
          },
          "priority": {
            "description": "Task priority from 1 (normal) to 4 (urgent) (optional)",
            "enum": [
              1,
              2,
              3,
              4
            ],
            "type": "number"
          },
          "project_id": {
            "description": "ID of the project to add the task to (optional)",
            "type": "string"
          },
          "section_id": {
            "description": "ID of the section to add the task to (optional)",
            "type": "string"
          }
        },
        "required": [
          "content"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Todoist MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Todoist MCP Server

Related Tools