delete_transaction

Deletes one transaction by transactionId for the authenticated user.

Use with an AI agent

Export this page as Markdown or bundle it with a task for your agent.

Try a task
Preview the prompt that will be copied

Access

  • Effect: Deletes data
  • Required scope: write (the mcp scope also grants it)

Example request

The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_transaction",
    "arguments": {}
  }
}

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

Description

Deletes one transaction by transactionId for the authenticated user.

For exact transactions, set preserveExactAmounts and expectedExactVersion from a precision-aware read.

If transactionId is unknown, pass transactionNameHint (e.g. "coffee" / "parking") or useLatestTransaction=true for the most recent entry (without a hint, this returns the resolved entry to confirm and does not delete yet).
If several match the hint, this asks which one — do not guess (even when useLatestTransaction is set).

Safety workflow:
  1) Prefer transactionId from create_transaction when undoing what was just logged.
  2) Otherwise resolve via transactionNameHint / useLatestTransaction, or list_transactions.
  3) Confirm what was removed in plain language.

Input parameters

NameTypeRequiredDescription
expectedExactVersionstringNo
preserveExactAmountsbooleanNo
transactionIdstringNo
transactionNameHintstringNo
useLatestTransactionbooleanNo
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "expectedExactVersion": {
      "type": "string"
    },
    "preserveExactAmounts": {
      "type": "boolean"
    },
    "transactionId": {
      "type": "string"
    },
    "transactionNameHint": {
      "type": [
        "null",
        "string"
      ]
    },
    "useLatestTransaction": {
      "type": [
        "null",
        "boolean"
      ]
    }
  },
  "type": "object"
}