Skip to content

list_tasks

태스크 조회 — 자연어 + 18개 필터 지원.

시그니처

json
{
  "name": "list_tasks",
  "arguments": {
    "status": "pending",
    "due_today": true,
    "is_important": true,
    "limit": 20
  }
}

파라미터 전체

상태

파라미터
statuspending / completed
is_importantboolean
overdueboolean — 마감 지난 미완료
due_todayboolean — 오늘 마감
has_notificationboolean

검색 / 위치

파라미터설명
search내용 키워드
location위치 부분일치 (예: "여의도", "서울")
category_id카테고리 UUID

날짜 범위

파라미터설명
due_date_startISO 8601, due_date >= 이 값
due_date_enddue_date <= 이 값
completed_date_start완료일 >=
completed_date_end완료일 <=
created_date_start생성일 >=
created_date_end생성일 <=

정렬 / 페이징

파라미터기본
sort_bydue_date / created_at / completed_at / updated_at / is_importantcreated_at
sort_orderasc / descdesc
limit1~50025

자연어 호출 예시

발화파라미터
"오늘 할 일"{ due_today: true }
"이번 주 마감"{ due_date_start: "<월요일>", due_date_end: "<일요일>" }
"마감 지난 미완료"{ overdue: true, sort_by: "due_date", sort_order: "asc" }
"여의도에서 중요한 미완료"{ location: "여의도", is_important: true, status: "pending" }
"지난달 완료 업무 카테고리"{ category_id: "...", status: "completed", completed_date_start: "...", completed_date_end: "..." }

응답

json
{
  "content": [
    {
      "type": "text",
      "text": "[Formatted task list]"
    },
    {
      "type": "resource",
      "resource": {
        "uri": "ainote://tasks/list",
        "mimeType": "application/json",
        "text": "{\"tasks\":[...]}"
      }
    }
  ]
}

structured data 는 content[1].resource.text 의 JSON 에 포함.

에러

코드메시지
-32602Invalid date format (expected ISO 8601)
-32602Invalid sort_by value

Claude

오늘 할 일 보여줘
이번 주 마감 중요한 거
강남에 있는 미완료 태스크

다음

MIT License · ainote.dev