ledger

記録する前に確認する

まず現在のsummaryを確認します。ledger recordはfinancial dataであり、欠落よりも重複のほうが判断しにくいためです。

ledger({ action: "summary", months: 1 })

公開 MCP ツール

ledger

用途

governedなfinancial transactionとexternal-service renewal reminderをLedger dispatcherで管理し、structured summaryとaudit boundaryを提供します。

適用シーン

amount、currency、date、merchant contextを含むexpenseまたは対応しているtransactionを記録する場合。
date、category、currency、project filterで認可済みLedger recordをlist、summary、overviewする場合。
subscription renewal reminderを作成または管理し、そのreview cycleをTODOに接続する場合。

非推奨シーン

financial recordにgeneric rememberを使わないでください。ledgerはfinancial data contractを保持します。
cross-currency totalを推測しないでください。aggregationが安全でない場合、summaryはcurrencyを分けて扱います。
必要なexact ID/versionとuser authorizationなしにrecordをupdateまたはdeleteしないでください。
REST APIはpublic MCP toolより広いfield setを受け付けます。scope、bucket、team、provenance filterについては/docs/api/memoryを参照してください。

必須スコープ

Read actionにはmemory:read、public chat surfaceでのtransactionとsubscription mutationにはmemory:writeが必要です。
認証済みのowner/team/scope boundaryが、すべてのLedger recordとreminder operationを管理します。

パラメーター

名前	型	説明
`action`	add_expense \| list \| summary \| overview \| update_transaction · 必須	callerが選択したLedger operationです。これら5つのliteral valueだけが受け付けられます。
`item / amount / transaction_type / currency`	string / number	主要なtransaction fieldです。financial writeにはamountとcurrencyが必要です。
`transaction_date / category / merchant / payment_method / note`	string	任意のtransaction classification、date、note fieldです。
`query / date_from / date_to / min_amount / max_amount`	string / number	Listとsummaryのfilterです。
`transaction_id / expected_version / patch`	string / integer / object	exact update target、optimistic concurrency version、許可されたupdate fieldです。
`owner_timezone / project_id`	string	date interpretationと認可済みproject/team boundaryです。
`limit / offset / months`	integer / boolean · デフォルト: 20 / 0 / 6 / false	pagination、summary horizon、structured-output controlです。

返却スキーマ

Structured outputには要求されたtransaction、summary group、またはoverviewと、user-facing text summaryが含まれます。Widget callerにはrefresh metadataが返る場合があります。raw secretsはresponse contractに決して含まれません。

使用例

expenseを記録する

ledger({
  action: "add_expense",
  item: "Domain renewal",
  amount: 18.00,
  currency: "USD",
  transaction_date: "2026-08-21",
  category: "software"
})

月次summaryを確認する

ledger({ action: "summary", months: 1 })

エラー

Authorization failure: tokenにread用のmemory:read、またはmutation用のmemory:writeがありません。
Validation failure: 必須のtransaction field、date format、currency、またはaction valueが無効です。
Concurrency failure: updateのexpected_versionが古いか、exact transactionが見つかりません。
Aggregation boundary: 異なるcurrencyのrecordは、誤ったcombined totalを作らず別々に報告されます。

remember — record周辺のnon-financial durable contextにだけ使用します。
todos — 一般的なfollow-up taskにはTODOを使い、ledgerではreview reminderを任意に追加できます。
forget — review済みのLedger recordを、そのgoverned lifecycleを通じて削除します。

出典: MCPリファレンス