Decknote

List the boards you can access and their lists. Start here: the returned board and list ids are what the other tools need.

{
  "type": "object",
  "properties": {
    "includeArchived": {
      "type": "boolean",
      "description": "Include archived boards. Default false."
    }
  }
}

Create a new board you own. Optional template picks the initial lists and labels (created in your account's language): 'blank' (To do / In progress / Done), 'kanban', 'content' or 'personal'. Returns the board with its list ids, ready for create_task.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "template": {
      "type": "string",
      "enum": [
        "blank",
        "kanban",
        "content",
        "personal"
      ],
      "description": "Initial lists/labels. Default 'blank'."
    },
    "lists": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Your own list titles, in order, instead of the template's (its labels stay)."
    }
  },
  "required": [
    "title"
  ]
}

Add a list (column) to a board — at the end, or first with `first: true`. Returns its id for create_task / move_task.

{
  "type": "object",
  "properties": {
    "boardId": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "first": {
      "type": "boolean",
      "description": "Put it before the other lists. Default false."
    }
  },
  "required": [
    "boardId",
    "title"
  ]
}

Search your tasks (cards) — the recall tool. Filter by free text (matches title and description), board, list, status and due date. Use this to answer 'what's still open', 'what did I note about X', 'what's due soon'.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text; matches card title and description."
    },
    "boardId": {
      "type": "string"
    },
    "listId": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "completed",
        "all"
      ],
      "description": "Default 'open'."
    },
    "dueBefore": {
      "type": "string",
      "description": "ISO 8601; only tasks due before this instant."
    },
    "limit": {
      "type": "number",
      "description": "Max results, 1–100. Default 20."
    }
  }
}

Read one task in full: title, description, due date, completion, and which board/list it's in.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    }
  },
  "required": [
    "cardId"
  ]
}

Add a task (card). Provide listId, or boardId to drop it in that board's first list. Title is required; description becomes the card's page and accepts Markdown (headings, bullet/numbered lists, - [ ] task lists, bold/italic/code, links, fenced code).

{
  "type": "object",
  "properties": {
    "listId": {
      "type": "string"
    },
    "boardId": {
      "type": "string",
      "description": "Used if listId is omitted."
    },
    "title": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "dueDate": {
      "type": "string",
      "description": "ISO 8601."
    },
    "reminders": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "Either `at` (ISO 8601 instant), or relative to the due date: `daysBefore` (0 = that day) + `time` (local HH:MM, default 09:00) in `timeZone` (IANA, e.g. America/Argentina/Buenos_Aires).",
        "properties": {
          "at": {
            "type": "string"
          },
          "daysBefore": {
            "type": "integer"
          },
          "time": {
            "type": "string"
          },
          "timeZone": {
            "type": "string"
          }
        }
      },
      "description": "Reminders for you (push and email)."
    },
    "recurrence": {
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "biweekly",
        "monthly"
      ],
      "description": "Repeat: archiving the task creates the next one, dates and reminders moved (Pro; needs a due date)."
    },
    "checklist": {
      "type": "object",
      "description": "A checklist on the card: { title?, items: [{ text, done? }] }.",
      "properties": {
        "title": {
          "type": "string"
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string"
              },
              "done": {
                "type": "boolean"
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "title"
  ]
}

Edit a task's title, description or due date. Description accepts Markdown; note that setting it REPLACES the card's page (use add_comment for incremental notes). Pass dueDate null to clear it.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "dueDate": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO 8601, or null to clear."
    },
    "recurrence": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "daily",
        "weekly",
        "biweekly",
        "monthly",
        null
      ],
      "description": "Repeat on archive (Pro), or null to stop repeating."
    }
  },
  "required": [
    "cardId"
  ]
}

Mark a task done.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    }
  },
  "required": [
    "cardId"
  ]
}

Reopen a completed task.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    }
  },
  "required": [
    "cardId"
  ]
}

Archive a task — the cleanup tool. Soft-delete: the card leaves the board but keeps its data and can be restored from the board's Archived panel. Archiving a dated recurring task schedules its next occurrence, same as archiving from the UI.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    }
  },
  "required": [
    "cardId"
  ]
}

Move a task to a different list (e.g. from 'To do' to 'Doing'). The target list must be one you can edit.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Target list id."
    }
  },
  "required": [
    "cardId",
    "listId"
  ]
}

Add a comment to a task — useful for leaving progress notes a human will read.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    },
    "text": {
      "type": "string"
    }
  },
  "required": [
    "cardId",
    "text"
  ]
}

Remind yourself about a task: a push notification and an email at a chosen moment. Give `at` (ISO instant), or a time relative to the due date (`daysBefore` + local `time` + `timeZone`) that follows the due date if it moves and repeats with recurring cards.

{
  "type": "object",
  "properties": {
    "cardId": {
      "type": "string"
    },
    "at": {
      "type": "string"
    },
    "daysBefore": {
      "type": "integer"
    },
    "time": {
      "type": "string"
    },
    "timeZone": {
      "type": "string"
    }
  },
  "required": [
    "cardId"
  ]
}

Your pending reminders (soonest first), optionally on one board — with each task's title and due date.

{
  "type": "object",
  "properties": {
    "boardId": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "description": "Default 50, max 200."
    }
  }
}

Delete one of your reminders.

{
  "type": "object",
  "properties": {
    "reminderId": {
      "type": "string"
    }
  },
  "required": [
    "reminderId"
  ]
}

Search the cards of every board you can access by text (title and description), open or completed. Returns ids to read in full with fetch.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to look for."
    }
  },
  "required": [
    "query"
  ]
}

Read one card in full by id (from search or search_tasks): title, board and list, due date, description, checklists and comments.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The card id."
    }
  },
  "required": [
    "id"
  ]
}