can_i_afford
ChatGPTAnalyze if a purchase is affordable. Returns verdict (green/yellow/red) with impact on budget, savings rate, and financial score.
create_category
ChatGPTCreate a new income or expense category with optional budget limit.
create_list
ChatGPTCreate a new financial list to organize transactions (e.g., "Groceries", "Travel").
create_scenario
ChatGPTCreate a scenario. Existing scenarios stay available unless they are deleted in the app.
create_transaction
ChatGPTCreate a single income or expense transaction. Prefer this tool when adding one transaction at a time. The label drives category matching: if no category matches the label (case-insensitive), one is auto-created with the same type and icon.
export_transactions
ChatGPTExport transactions as CSV. Filter by date range, year/month, or stored label. Returns CSV text with summary.
get_financial_score
ChatGPTCalculate financial health score (0-100) with breakdown by savings rate, budget adherence, spending trend, and tracking consistency. Includes safe-to-spend amount.
get_import_template
ChatGPTGet the expected format for importing transactions: column definitions, types, validation rules, and examples.
get_recurring_expenses
ChatGPTDetect recurring/subscription expenses by analyzing transaction patterns across months. Returns monthly total of detected subscriptions.
get_scenario
ChatGPTGet one scenario by ID or name. If there is exactly one scenario, it can be returned without an identifier. If multiple scenarios exist, provide scenario_id or scenario_name.
get_spending_insights
ChatGPTGet active spending insights: budget alerts, anomalies, positive trends, and safe-to-spend. Analyzes current month vs previous 2 months.
get_time_to_earn
ChatGPTConvert expenses to work hours. With amount: how long to earn that amount. Without: top 5 categories by work hours needed.
get_transaction_summary
ChatGPTGet a compact aggregated summary for a period: income, expenses, balance, and transaction count. Prefer this over get_transactions when totals are enough and you do not need to inspect individual records.
get_transactions
ChatGPTGet itemized transactions for a specific list and time period (year, month, day). Returns matching records plus totals. Use this when you need the individual transaction list.
get_transactions_by_range
ChatGPTGet transactions within a custom date range. Can filter by category label.
import_transactions
ChatGPTBulk import transactions (max 100). Use this only when creating many transactions at once, not for a single entry. Validates each row before insertion. The list_id accepts an ID or exact list name (default: "Personal"). Categories are auto-created when a label does not match any existing category (case-insensitive match).
list_categories
ChatGPTGet all income and expense categories. Can filter by type (income/expense).
list_lists
ChatGPTGet all financial lists for the authenticated user. Returns list names, emojis, and favorite status.
list_scenarios
ChatGPTList saved scenarios for a list.
simulate_savings
ChatGPTEstimate savings by reducing existing historical spending on a stored transaction label. This is behavior-driven from past expense data, not a free-form hypothetical savings target. Requires matching expense history and projects the reduced-spend scenario over N months.
update_scenario
ChatGPTUpdate scenario fields by scenario_id or scenario_name.