tasks_add

Add new tasks with specific statuses in batch or individually using CLI. Includes options for task placement and inferred statuses for efficient task management within MCP Tasks.

Instructions

Add new tasks with a specific status. It's faster and cheaper if you use this in batch. User can add atomically while AI works using the CLI add tool

Input Schema

Name	Required	Description
`index`	No	0-based index to place the tasks. e.g.: - 0 for "Do this next" - Omit to place at the end ("Do this later")
`source_id`	No	Source ID from task_setup() response - Defaults to most recent in the workspace if not provided - Try to always provide it! - If you don't have it, ask the user for a file path and call task_setup()
`status`	Yes	You might need to infer it from the context: - "To Do" for tasks coming up next (e.g. "Do X next") - "In Progress" for what you'll do now (e.g. "First do X") - "Reminders" instructions for you (the AI) to be constantly reminded of - "Notes" to collect non-actionable notes
`texts`	Yes	Each text becomes a task

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "index": {
      "description": "0-based index to place the tasks. e.g.:\n- 0 for \"Do this next\"\n- Omit to place at the end (\"Do this later\")",
      "minimum": 0,
      "type": "integer"
    },
    "source_id": {
      "description": "Source ID from task_setup() response\n- Defaults to most recent in the workspace if not provided\n- Try to always provide it!\n- If you don't have it, ask the user for a file path and call task_setup()",
      "minLength": 1,
      "type": "string"
    },
    "status": {
      "description": "You might need to infer it from the context:\n- \"To Do\" for tasks coming up next (e.g. \"Do X next\")\n- \"In Progress\" for what you'll do now (e.g. \"First do X\")\n- \"Reminders\" instructions for you (the AI) to be constantly reminded of\n- \"Notes\" to collect non-actionable notes",
      "enum": [
        "In Progress",
        "To Do",
        "Backlog",
        "Done",
        "Reminders",
        "Notes",
        "Deleted"
      ],
      "type": "string"
    },
    "texts": {
      "description": "Each text becomes a task",
      "items": {
        "minLength": 1,
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "texts",
    "status"
  ],
  "type": "object"
}

MCP Tasks

tasks_add

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Tasks

Related Tools

MCP directory API