Summarize transactions
wave_summarize_transactionsTotals matching transactions by category, month, vendor, customer, or account to answer spending and income questions without paging individual records.
Instructions
Totals over every matching transaction, grouped by category, month, vendor, customer or bank/card account: how much was spent on Marketing this year, spend per month, top vendors. Pages through Wave itself and returns only the totals, so use it instead of paging wave_list_transactions to add things up. Same filters as wave_list_transactions. Sums line amounts (which include sales tax): money-out lines (debits) are withdrawals, money-in lines (credits) are deposits; journal entries count by the same debit/credit rule. With categoryIds, only the lines in those categories count, so split transactions are not double counted. Uses Wave's web-app API (unofficial), which needs a web session: if it is missing or expired, the user runs node /app/bin/wave-mcp.js login in a terminal on 1c94a9392181.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "wave_summarize_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | Text in the transaction description or a line description (case-insensitive) | |
| source | No | Where it came from: MANUAL = statement upload; PLAID/YODLEE/CASHEDGE = bank connection; GENERIC_EXTERNAL_API = API (wave_create_transaction); RECEIPT/RECEIPT_CAPTURE = receipts. Entries typed into Wave have no source | |
| endDate | No | Latest transaction date (inclusive) | |
| groupBy | No | account = the bank/card account; none = totals only | category |
| accountId | No | Bank or card account (wave_list_accounts): transactions paid from or into it. An income/expense category given here is treated as categoryIds | |
| maxGroups | No | Largest groups to return; the rest are added up in otherGroups | |
| startDate | No | Earliest transaction date (inclusive) | |
| businessId | No | Business ID; defaults to the one wave_get_context reports | |
| categoryIds | No | Category accounts (income/expense, wave_list_accounts with search): transactions with a line in any of them | |
| uncategorizedOnly | No | Only transactions still in Uncategorized Income/Expense |