attach_file
ChatGPTAttach a file (base64) to a transaction, invoice, asset, bank loan, EMI row, loan event or ledger entry: a receipt photo, a bank letter, proof of payment. Counts against the monthly attachment allowance.
cancel_scheduled
ChatGPTCancel a scheduled transaction so it never posts. This cannot be undone (it stays in history as cancelled). Confirm with the user first.
convert_currency
ChatGPTConvert an amount between currencies at the rate of a given date.
create_account
ChatGPTCreate an account. Free plan has an account limit; the error says so when reached.
create_asset
ChatGPTTrack an asset. Gold and silver are priced per tola (11.664 g) in Nepal; put weight and purity in metadata. Premium.
create_budget
ChatGPTCreate a budget. scope=category tracks listed categories, all tracks every expense, manual only counts transactions assigned to it. Dates are Gregorian, even if the user plans by another calendar such as Bikram Sambat.
create_category
ChatGPTCreate a category. Check list_categories first so you do not make a duplicate.
create_invoice
ChatGPTCreate a draft invoice with line items; totals, tax and discounts are calculated for you. Premium.
create_recurring
ChatGPTSet up a monthly recurring expense (rent, internet, school fees, a subscription). It posts itself every month from next_date. Bank-loan EMIs belong in the loan tools instead. Premium.
create_scheduled
ChatGPTSchedule a one-time future expense; it posts itself on the date. Premium.
create_split
ChatGPTSplit a bill with people. Members are Lipi users (by email) or ghosts (just a name). Shares are equal unless share_amount is given.
create_transaction
ChatGPTRecord one expense or income. The account balance updates. For several at once (a statement, a receipt list) use create_transactions.
create_transactions
ChatGPTRecord several expenses or incomes in one call: a bank statement, an SMS list, a receipt photo with many lines. Each item is checked on its own; the result lists what was created and what failed and why. Up to 100 items. Show the user what you are about to add before calling.
create_transfer
ChatGPTMove money between two of the user's own accounts (also credit card payments, wallet top-ups, cross-currency moves). Not income or spending.
delete_account
ChatGPTDelete an account. Ask the user to confirm first: its transactions go with it.
delete_asset
ChatGPTStop tracking an asset. Confirm with the user first.
delete_bank_loan
ChatGPTDelete a bank loan with its schedule. Booked EMI transactions stay. Confirm with the user first.
delete_bank_loan_event
ChatGPTRemove a prepayment or foreclosure from a loan.
delete_budget
ChatGPTDelete a budget. Transactions stay. Confirm with the user first.
delete_category
ChatGPTDelete a category. Its transactions stay, uncategorised. Confirm with the user first.
delete_invoice
ChatGPTDelete an invoice. Confirm with the user first.
delete_ledger
ChatGPTDelete a people ledger. Confirm with the user first.
delete_ledger_entry
ChatGPTDelete a ledger entry you added. It disappears for the other person too.
delete_recurring
ChatGPTDelete a recurring expense. Already posted transactions stay.
delete_scheduled
ChatGPTDelete a scheduled transaction.
delete_transaction
ChatGPTDelete a transaction; the account balance is restored. Confirm with the user first.
export_transactions_csv
ChatGPTTransactions as CSV text, for a spreadsheet or a deeper analysis. Premium.
get_account
ChatGPTOne account with its balance, currency and settings.
get_account_balance_trend
ChatGPTDaily closing balance of one account over the last N days.
get_activity_log
ChatGPTRecent changes on the user's books (who created, edited or deleted what, including from shared accounts and AI connections).
get_asset_summary
ChatGPTTotal asset value by type in the default currency. Premium.
get_bank_loan
ChatGPTOne bank loan with its full EMI schedule (rows by seq: due date, EMI, interest, principal, balance, actual/estimated, paid state) and prepayment/foreclosure events.
get_bills_radar
ChatGPTRecurring bills due in the next 30 days that are not yet posted, and the total committed this month. Premium.
get_budget_progress
ChatGPTHow much of each budget is used this period: spent, remaining, percent, and whether it is over.
get_cash_flow
ChatGPTMoney in vs money out by day over a window. Premium.
get_category_movers
ChatGPTCategories whose spending changed most this month against the same days of last month. Premium.
get_exchange_rates
ChatGPTExchange rates for a date. source=nrb is Nepal Rastra Bank's published rate (used for tax); market is the traded rate. Never assume today's rate for a past date.
get_intent_trend
ChatGPTMonth-by-month spending by intent for the last N months.
get_invoice
ChatGPTOne invoice with its line items and payments. Premium.
get_ledger
ChatGPTOne people ledger with all entries, interest terms and balance.
get_metal_prices
ChatGPTToday's gold and silver prices in Nepal (FENEGOSIDA), per tola by default.
get_nepse_index
ChatGPTLatest NEPSE index value and change.
get_net_worth_trend
ChatGPTNet worth month by month with a projection ahead. Premium.
get_overview
ChatGPTStart here. Who the user is, today's date and timezone, default currency, date preference (AD/BS), plan, every account with its balance and every category with its id. Call once at the start of a conversation instead of several list calls.
get_plan
ChatGPTThe user's plan (free, free Premium grant, paid Premium), when free Premium ends, its limits and which features need Premium.
get_recurring_expenses
ChatGPTThe user's active recurring expenses (subscriptions, rent…) with amount, frequency and next due date, and the total committed per month. Premium.
get_savings_rate
ChatGPTShare of income saved in each of the last 12 months, with an optional target. Premium.
get_scan
ChatGPTResult of a receipt scan started with scan_receipt: status (pending, classified, failed) and the proposed merchant, date, total, category and account.
get_settings
ChatGPTUser settings: default currency, language, date format (AD or BS), invoice prefix, notification time.
get_spending_by_intent
ChatGPTSpending split by intent (essential, unavoidable, avoidable, goodwill) and category for a period, spending bucket only. Good for "where did my money go".
get_spending_forecast
ChatGPTMonth-end spending estimate from this month's daily pace so far. Premium.
get_split
ChatGPTOne split with members, shares, settlements and balances.
get_splits_summary
ChatGPTNet amounts across all splits: what the user owes and is owed, per person.
get_transaction
ChatGPTOne transaction with category, account, tags, attachments and its version (needed by update_transaction).
get_transaction_summary
ChatGPTIncome, spending, excluded and tax totals between two dates, in the user's default currency, split by bucket.
get_unusual_spend
ChatGPTExpenses in the last 30 days above twice their category's usual monthly spend. Premium.
list_accounts
ChatGPTList the user's accounts (bank, wallet, cash, investment, credit card) with current balances and currency. Includes accounts shared with the user. Call this before adding transactions to find account ids.
list_assets
ChatGPTAssets the user tracks (gold, silver, land, investments, retirement funds…) with current value. Premium.
list_bank_loans
ChatGPTBank loans with principal, rate, tenure, EMI, balance and next due row. Use the client_id of a loan as loan_id in the other loan tools. Premium.
list_budgets
ChatGPTList budgets with amount, period, scope and categories.
list_categories
ChatGPTList categories with ids, type (expense, income, transfer), intent and parent. Use the ids when adding or filtering transactions.
list_clients
ChatGPTInvoice clients with contact details and totals. Premium.
list_currencies
ChatGPTCurrencies the user can pick for accounts and transactions.
list_identities
ChatGPTWho invoices can be from: the user's saved identities (personal, freelancer, sole proprietor, company, partnership, nonprofit or other), with the default flagged. Pass an id as identity_id to create_invoice.
list_invoices
ChatGPTInvoices with client, totals, due date and status (draft, sent, paid, overdue, cancelled). Premium.
list_ledgers
ChatGPTPeople ledgers: money lent to or borrowed from friends and family, with the running balance and who owes whom. Use a ledger's client_id as ledger_id.
list_notifications
ChatGPTIn-app notifications (budget alerts, EMI reminders, low balance, shares…).
list_recurring
ChatGPTMonthly recurring expenses (rent, subscriptions, EMIs not tracked as loans) with next date and whether they are active.
list_scheduled
ChatGPTOne-time future transactions waiting to be posted.
list_splits
ChatGPTShared bills split with other people, with who paid and who owes.
list_transactions
ChatGPTList transactions, 15 per page (use page), newest first by default. Filter by type, account, category, budget, date range, text, reporting bucket or intent. Amounts are decimal strings; dates are Gregorian YYYY-MM-DD.
mark_notifications_read
ChatGPTMark one notification read (pass id) or all of them (leave id out).
pay_bank_loan_rows
ChatGPTMark EMIs paid, by installment number (seq). With book=true an expense transaction is recorded from account_id (or the loan's paying account); with transaction_id an existing transaction is linked instead; neither just ticks the row (right for past EMIs already in the books). Premium.
post_recurring_now
ChatGPTPost this month's transaction of a recurring expense now instead of waiting for its date.
post_scheduled_now
ChatGPTPost a scheduled transaction today.
read_document
ChatGPTRead a photo of a financial document (base64 image) into figures: a bank EMI schedule becomes rows for set_bank_loan_rows, a statement, receipt or SMS list becomes items for create_transactions. Use only if you cannot read the image yourself. Nothing is written; show the user the figures, then save them with those tools.
record_invoice_payment
ChatGPTRecord a payment received on an invoice; books income into the account when one is given.
record_split_settlement
ChatGPTRecord that one member paid another back on a split.
save_bank_loan
ChatGPTCreate a bank loan (leave out loan_id) or change one (pass its loan_id). A new loan gets an estimated EMI schedule from its terms, computed exactly as the app does; when the user has the bank's real schedule (a statement photo, a letter), follow up with set_bank_loan_rows to replace the estimate with actual rows. Premium.
save_bank_loan_event
ChatGPTRecord a prepayment (part-payment) or a foreclosure (closing the loan early) on a bank loan, or change one (pass event_id). The schedule is not recalculated here: after a prepayment, write the bank's new rows with set_bank_loan_rows (mode replace) from its letter. Premium.
save_client
ChatGPTAdd an invoice client (leave out id) or overwrite an existing client's details (pass id). Every field is optional. Free.
save_ledger
ChatGPTCreate a people ledger for money lent to or borrowed from someone (leave out ledger_id), or change one: name, currency, simple interest, archive. Then add entries with save_ledger_entry. Free.
save_ledger_entry
ChatGPTAdd an entry to a people ledger (leave out entry_id) or change one you added. direction is from the user's side: out = the user gave money (lent, or repaid what they owed), in = the user got money. kind: payment (default), interest (interest paid; balance unchanged) or interest_added (interest put on what is owed).
scan_receipt
ChatGPTRun a receipt or bill photo (JPG, PNG, WEBP or PDF, base64) through Lipi's own scanner, the same one the app uses: it proposes merchant, date, total, currency and the user's category and account, and keeps the image for attaching. Counts against the monthly scan allowance. Waits up to ~20 s, then returns the scan; if still pending, check again with get_scan. Nothing is recorded until you call create_transaction with the figures.
search
ChatGPTSearch across transactions, categories, accounts, clients and invoices.
set_bank_loan_rows
ChatGPTOverwrite EMI schedule rows on a bank loan, matched by installment number (seq). This is how a repayment schedule from a photo, PDF or bank letter becomes the loan's real schedule: read every row (due date, EMI, interest, principal, balance after, rate) and send them as kind "actual". merge (default) overwrites only the seqs you send; replace also deletes unpaid rows you did not send (after a prepayment or rate change the bank issues a new schedule). The server stores rows as given and never recalculates; paid rows are never deleted. Premium.
set_invoice_status
ChatGPTMark an invoice sent, paid, overdue or cancelled. To record money received use record_invoice_payment instead.
toggle_recurring
ChatGPTPause or resume a recurring expense (flips its active state).
unpay_bank_loan_rows
ChatGPTUndo "paid" on EMIs, by installment number (seq). A transaction that was booked for them stays; delete it separately if the user wants. Premium.
update_account
ChatGPTChange an account's name, type, low-balance warning or colour. It can also archive the account (is_active=false) or overwrite its balance, which changes the books; confirm those with the user first. Only the fields given change.
update_asset
ChatGPTUpdate an asset (most often its current value). Premium.
update_budget
ChatGPTChange a budget. Only the fields given change.
update_category
ChatGPTRename a category or change its intent, parent or colour.
update_invoice
ChatGPTChange an invoice in any status; every save is kept in its history. Sending items replaces all line items. Free.
update_recurring
ChatGPTChange a recurring expense. Only the fields given change.
update_scheduled
ChatGPTChange a scheduled transaction before it posts.
update_settings
ChatGPTChange user settings. Only the fields given change.
update_split
ChatGPTChange a split's name, amount, date, payer or shares.
update_transaction
ChatGPTChange a transaction: amount, date, account, category, budget, description, tags, bucket or intent. Only the fields given change. The current version is looked up for you unless you pass it.