Tools

avenir-mcp declares these tools. Read-only tools are always available; write tools exist only with AVENIR_MCP_WRITE=1, and every one of them but approve_transactions and import_transactions is previewed and confirmed.

Read

Tool	Summary
find_recurring_charges	List the subscriptions and other charges paid every month, with their yearly cost.
find_transactions	Find transactions by date, amount, account, category or payee, categorised or not.
forecast_balance	Project the balance month by month and say when money would run out.
get_budget_vs_actual	Share of each category’s budget spent in a month, to see what is over or close.
get_category_balances	Budgeted, spent (activity) and available (balance) per category for a month.
get_monthly_summary	A month at a glance: income, budgeted, spent, Ready to Assign, overspent categories.
get_spending_trends	Spending per category, month by month, over the last N months.
list_accounts	List the plan’s accounts with their balances, bank link and last reconciliation.
list_category_groups	List the category groups a new category can be created in.
list_plans	List all YNAB plans accessible with the current API key.
list_scheduled_transactions	List the scheduled transactions due between two dates: bills, salary, transfers.
suggest_categories	List the transactions waiting for a category, with a suggestion when history allows.

Write

Tool	Summary
apply_categories	Assign categories to transactions, after the user confirms, and journal it for undo.
approve_transactions	Mark transactions as approved, i.e. reviewed (clears YNAB’s “unapproved” badge).
create_category	Create a category in a group, after the user confirms.
create_transactions	Create transactions on an account, e.g. ones the bank import missed, after the user confirms.
flag_transactions	Set or remove the coloured flag of transactions, after the user confirms.
import_transactions	Import the latest transactions from the plan’s linked bank accounts into YNAB.
move_money	Move money budgeted in one category to another for a month, after the user confirms.
reconcile_account	Compare an account with the balance your bank shows, then reconcile it.
set_category_budget	Set the amount budgeted (“Assigned”) in a category for a month, after the user confirms.
set_category_target	Set, change or remove a category’s target, after the user confirms.
split_transaction	Split one transaction across categories, e.g. from a receipt, after the user confirms.
undo_operation	Undo an operation made through this server: the latest one, or the one named.
update_category	Rename a category and/or move it to another group, after the user confirms.

Resources

URI	Description
avenir-mcp://guide	How to use this server’s tools, and the YNAB method in brief.
ynab://plans	The plans (budgets) the token can read, with the ids tools need.
ynab://plans/{plan_id}/categories	A plan’s assignable categories by group, with their ids.
ynab://plans/{plan_id}/accounts	A plan’s open accounts, balances in currency units.

Prompts

Prompt	Arguments	Description
classify_pending	plan_id	Classify the transactions waiting for a category.
monthly_review	plan_id, month (optional)	Review a month of a plan: where the money went and what needs attention.
reconcile	plan_id, account_id, bank_balance	Reconcile an account with the balance the bank shows.
plan_next_month	plan_id	Prepare next month’s category amounts from the forecast and this month’s categories.