📊 Budgets
Set spending limits by category or total, track budget progress and get alerts.
Automatic Notifications
Monaime automatically sends notifications when you reach 80% of a budget (warning) and when you exceed 100% (alert).
How budgets work
Budgets are stored as fields on categories (
budget_amount, budget_period, budget_currency). Current spending is computed in real-time from transactions for the budget period. No separate budgets table exists.
create_budget
SafeCreate a spending budget for a specific category or total spending. Budgets can be daily, weekly, monthly, or yearly.
Parameters
| Parameter | Type | Description |
|---|---|---|
| name? | string | Budget name (auto-generated from category if not provided) |
| category? | string | Category to track. If omitted, tracks total spending |
| limit* | number | Maximum spending amount |
| period? | string | daily, weekly, monthly (default), yearly |
Examples
User
"Create a food budget of 15,000 per month"
AI
Created budget "Food": $15,000/month. Spent: $0 (0%)
User
"Total budget 100,000 per month"
AI
Created total budget: $100,000/month
User
"Entertainment limit 5,000 per week"
AI
Created budget "Entertainment": $5,000/week
list_budgets
SafeShow all active budgets with current spending progress.
Parameters
| Parameter | Type | Description |
|---|---|---|
| include_inactive? | boolean | Include paused/inactive budgets. Default: false |
Examples
User
"Show my budgets"
AI
Your budgets:
• Food: $12,500/$15,000 (83%) ⚠️
• Transport: $3,200/$5,000 (64%)
• Entertainment: $1,500/$5,000 (30%)
• Food: $12,500/$15,000 (83%) ⚠️
• Transport: $3,200/$5,000 (64%)
• Entertainment: $1,500/$5,000 (30%)
User
"All budgets including inactive"
get_budget_status
SafeGet detailed status of a specific budget, including remaining amount and daily allowance.
Parameters
| Parameter | Type | Description |
|---|---|---|
| budget? | string | Budget name or category. Shows all if omitted |
Examples
User
"How much is left in the food budget?"
AI
Budget "Food" (monthly):
• Limit: $15,000
• Spent: $12,500 (83%)
• Remaining: $2,500
• Days left in period: 11
• Recommended per day: $227
• Limit: $15,000
• Spent: $12,500 (83%)
• Remaining: $2,500
• Days left in period: 11
• Recommended per day: $227
User
"How's the transport budget doing?"
edit_budget
SafeEdit a budget's limit, period, or pause/resume it.
Parameters
| Parameter | Type | Description |
|---|---|---|
| budget* | string | Budget name or category |
| limit? | number | New limit amount |
| period? | string | New period |
| is_active? | boolean | Pause (false) or resume (true) |
Examples
User
"Increase food budget to 20,000"
AI
Budget "Food" updated: $15,000 → $20,000/month
User
"Pause the entertainment budget"
AI
Budget "Entertainment" paused
delete_budget
Requires ConfirmationDelete a budget. Clears the budget limit from the category. Transaction history is preserved.
Parameters
| Parameter | Type | Description |
|---|---|---|
| budget* | string | Budget name or category to delete |
Examples
User
"Delete entertainment budget"
AI
Delete budget "Entertainment" ($1,500/$5,000)? [Yes/No]