CLI tool for managing shared expenses using Spliit API. Track household expenses, balances, and reimbursements. Use when Claude needs to record expenses, check who owes whom, or manage group finances.
Manage shared expenses using the Spliit API.
⚠️ ALWAYS check memory/spliit.md first before running any Spliit command. This file contains all managed groups with their IDs, members, and linked Telegram GCs.
The group ID is passed via the -g or --group flag. You can find the group ID in the URL: https://spliit.app/groups/<GROUP_ID>
When creating new groups: Always update memory/spliit.md with:
spliit create-group "Group Name" "Alice,Bob,Charlie"
spliit create-group "Trip" "Alice,Bob" --currency "$" --currency-code USD
Returns the new group ID and URL.
spliit -g <group-id> balances
Shows who owes whom and suggested reimbursements.
spliit -g <group-id> expenses
spliit -g <group-id> expenses --limit 10
spliit -g <group-id> expenses --limit 10 --page 2
spliit -g <group-id> expenses --from 2025-12-01
spliit -g <group-id> expenses --from 2025-12-01 --to 2025-12-31
spliit -g <group-id> expenses --show-ids # Show IDs for deletion
spliit -g <group-id> add-expense "Groceries" "Alice" 5000
spliit -g <group-id> add-expense "Movie tickets" "Bob" 3500 --category 1
Note: Amount is in cents (5000 = $50.00)
spliit -g <group-id> add-expense "Settle up" "Bob" 2500 --reimbursement --to "Alice"
Use the --reimbursement flag with --to to record a debt settlement. This is used when someone pays back money they owe.
Example workflow:
spliit -g <group-id> balances
spliit -g <group-id> add-expense "Settle up" "Bob" 2500 --reimbursement --to "Alice"Important:
--to flag is required when using --reimbursementspliit -g <group-id> delete-expense <expense-id>
Use expenses --show-ids to get expense IDs first.
spliit -g <group-id> participants
spliit -g <group-id> group
--reimbursement flag to record debt settlementsWhen performing actions that produce URLs, always include them in your response:
https://spliit.app/groups/<GROUP_ID>https://spliit.app/groups/<GROUP_ID>/expenses/<EXPENSE_ID>/edit (direct link to the expense)https://spliit.app/groups/<GROUP_ID>/balancesThis lets the user quickly verify or share the result.