propose_delete_transaction
Destructive
Propose deleting an existing income or expense transaction. Returns a proposal id; to record it, call the confirm_proposal tool with the returned proposalId after the user approves (there is no UI button or proposal card to click in this context). Look the target up with the read-query tool first and pass its id. Transfers, buys and sells can't be deleted here — tell the user to delete those on the Transactions page. Neither can IOUs, which are transfers to a virtual receivable/payable account — tell the user to manage those on the IOUs page. The preview states the full effect — relay it to the user before they confirm.
MCP note: this tool only CREATES a pending proposal; nothing is recorded until confirm_proposal is called.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| transactionId | Yes | Id of the transaction to delete. Look it up with the read-query tool (filtering by description/date/amount/etc.) before calling. Must be an income or expense: transfers, buys and sells belong on the Transactions page, and IOUs on the IOUs page. | |
| editsProposalId | No | Id of an existing pending delete proposal to update in place. Pass this when the user retargets a delete you previously proposed (e.g. 'actually delete the other one'). Look up current ids with listPendingProposals if you're unsure. Omit when proposing something new. |