add_cash_expense
Add one receiptless expense or client-provided expense advance to the expense sheet after the user confirms; no server preview, it writes on call. Ordinary expenses: list_categories first; use a configured Expense Account. Advances: isClientAdvance=true + clientName reuses/creates the canonical client group, applies Cash advance received and writes a negative expense. Only client money provided before spending; never for vendor refunds, reimbursements, earned fees, retainers or generic deposits. Multiple/incomplete entries, refunds, tax/tip/per diem: Manual expense link from get_spreadsheet_url.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"total": "<total>",
"date": "<date>"
},
"name": "add_cash_expense"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tax | No | Tax amount | |
| tip | No | Tip amount | |
| city | No | City/location | |
| date | Yes | Expense date (YYYY-MM-DD) | |
| notes | No | Notes or description | |
| total | Yes | Positive amount paid or received. ExpenseBot stores a client advance as negative. | |
| category | No | A configured Expense Account returned by list_categories. Do not invent a category. | |
| currency | No | Currency code (default: USD) | |
| merchant | No | Merchant/vendor name for an ordinary expense. Not needed for a client advance; ExpenseBot derives it from clientName. | |
| subtotal | No | Subtotal before tax | |
| clientName | No | Client name for a client advance, in ordinary language. ExpenseBot resolves the canonical Client – Name group. | |
| isClientAdvance | No | True only when a client supplied money in advance for expenses. Requires clientName and does not require category. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| expense | No | ||
| message | Yes | ||
| success | Yes | ||
| recordId | No | ||
| rowNumber | No | ||
| finalAnswer | No | ||
| spreadsheetUrl | No | ||
| responseGuidance | No | ||
| reviewExpensesUrl | No |