하나 더 추가하기 전에 열린 항목 목록 확인
먼저 읽으면 여러 agent가 동일한 project scope에서 작업할 때 중복 TODO를 피할 수 있습니다.
todo({ action: "list" })공개 MCP 도구
todo
목적
project context 가까이에서 task TODO를 생성, 업데이트, 완료, 목록 조회 또는 명시적으로 bulk-delete하면서 승인된 project context 안에 task state를 보존합니다.
사용 시점
- 사용자에게 영구 task state, due date, priority, completion 또는 handoff list가 필요한 경우.
- project workspace에서 signed mount capability를 사용하는 관리되는 TODO mutation이 필요한 경우.
- 승인된 open, in-progress, completed 또는 전체 item을 목록으로 조회해야 하는 경우.
사용하지 않을 시점
- 일반적인 영구 fact 또는 decision에는 TODO를 사용하지 않습니다. remember를 사용합니다.
- financial transaction을 TODO content로 저장하지 않습니다. ledger를 사용합니다.
- 명시적인 user request가 있고 confirm_delete_all=true인 경우가 아니면 delete_all을 호출하지 않습니다.
- REST API는 public MCP tool보다 더 넓은 field set을 허용합니다. scope, bucket, team 및 provenance filter는 /docs/api/memory를 참고합니다.
필수 스코프
- List에는 memory:read가 사용되고, public chat surface에서 create, update, complete 및 delete_all에는 memory:write가 사용됩니다.
- Project Workspace mutation에는 유효한 mount_capability와 project_id도 필요합니다.
매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
action | create | update | complete | list | delete_all · 필수 | Dispatcher operation입니다. |
todo_id | string | update 또는 completion에 사용할 정확한 item ID입니다. |
content / title | string | Task text입니다. 둘 다 제공하면 서로 일치해야 합니다. |
project_id | string | 승인된 project workspace identifier입니다. |
priority / due_at / status / note | string | Task priority, due timestamp, status transition 및 handoff note입니다. |
item_status / due_before / search / query | string | List filter입니다. search와 query는 list 전용이며 둘 다 제공하면 서로 일치해야 합니다. |
limit / cursor / owner_timezone | integer / string · 기본값: 20 / empty / configured timezone | Pagination 및 날짜 해석 제어입니다. |
client_mutation_id / expected_version | string / integer | create/update의 idempotency key와 update의 optimistic concurrency version입니다. |
confirm_delete_all | boolean · 기본값: false | 명시적인 복구 가능한 bulk deletion에 필요한 true 값입니다. |
반환 스키마
Structured output은 action을 식별하고 영향을 받은 item(s), pagination cursor, mutation status 및 안전한 task metadata를 반환합니다. Bulk deletion은 항상 복구 가능한 soft deletion입니다.
예제
todo({
action: "create",
content: "Review the MCP scope matrix",
client_mutation_id: "task-review-scope-001",
due_at: "2026-08-25T09:00:00Z"
})todo({ action: "list", item_status: "open", limit: 10 })오류
- Authorization failure: list에 memory:read가 없거나 mutation에 memory:write/project capability가 없습니다.
- Validation failure: create에 client_mutation_id가 없거나 update에 양수 expected_version이 없거나 action field가 충돌합니다.
- Safety rejection: delete_all에는 명시적인 confirmation이 필요하며 widget/mount-capability caller는 사용할 수 없습니다.
- Timezone, project 또는 optimistic-concurrency error가 명시적으로 반환되며 dispatcher는 field를 조용히 무시하지 않습니다.
관련 도구
- remember — task의 근거가 되는 영구 decision 또는 fact를 저장합니다.
- recall_context — 계속하기 전에 task와 project context를 복원합니다.
- forget — 필요할 때 정확한 ID로 검토된 TODO 하나를 제거합니다.
출처: SDK workflow 도우미