Record a payment
settle_upRecord an already-completed payment to close an outstanding Splitwise balance. It defaults to the full amount, shows a preview, and waits for confirmation before updating the record.
Instructions
Record that money changed hands, so the balance closes in Splitwise. Use this after you actually paid someone (or they paid you) through Venmo, UPI, a bank transfer or cash. Defaults to the full outstanding balance. Shows a preview and waits for confirmation. This does not move money; it records a payment that already happened.
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": {
"friend": "<friend>"
},
"name": "settle_up"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | YYYY-MM-DD. Defaults to today. | |
| amount | No | Decimal string like "61.00". Defaults to the full outstanding balance with this person. | |
| friend | Yes | Member name or id. | |
| currency | No | ||
| group_id | No | Record it inside a group. Otherwise it is a direct payment. | |
| direction | No | Who handed over the money. | i_paid |
| idempotency_key | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ||
| from | No | ||
| note | Yes | ||
| amount | No | Decimal amount as a string, two places, e.g. "84.00" | |
| currency | No | ||
| recorded | Yes | ||
| expense_id | No |