todos

もう1件追加する前にopen itemを一覧する

先に読み取ることで、同じproject scopeで複数のagentが作業しているときのTODO重複を防げます。

todo({ action: "list" })

公開 MCP ツール

todo

用途

認可されたproject contextの近くでtask stateを保ちながら、project TODOを作成、更新、完了、一覧表示、または明示的にbulk-deleteします。

適用シーン

ユーザーに永続的なtask state、期限、priority、completion、またはhandoff listが必要な場合。
project workspaceでsigned mount capabilityを使うgoverned TODO mutationが必要な場合。
callerが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に使うexact 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とdate interpretationの制御です。
`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です。

使用例

Idempotentなtaskを作成する

todo({
  action: "create",
  content: "Review the MCP scope matrix",
  client_mutation_id: "task-review-scope-001",
  due_at: "2026-08-25T09:00:00Z"
})

Open taskを一覧する

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にpositiveな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 — 必要な場合にexact IDでreview済みのTODOを1件削除します。

出典: SDKワークフローヘルパー