Limitations and roadmap
Known limitations
Section titled “Known limitations”| Area | Limitation | Workaround |
|---|---|---|
| Confirmation codes | kept in memory: a server restart forgets them | ask again for a new preview |
| Undo | local to the machine whose journal recorded the operation; an undo cannot be undone | redo the change |
approve_transactions |
applies at once, without preview | it only clears YNAB’s review flag |
update_category, create_category |
not undoable; YNAB’s API cannot delete a category | rename back; hide the category in YNAB |
| HTTP transport | plain HTTP, one shared token, no user accounts | keep it on 127.0.0.1, or use stdio |
| Public or shared server | not supported: no user accounts, and YNAB’s terms require OAuth for others’ budgets | each person runs their own avenir-mcp — see the legal notice |
| Split transactions | never suggested nor recategorised: their lines carry the categories; split_transaction splits one, but YNAB’s API cannot change or undo a split |
change or undo them in YNAB |
| Suggestions | need a history: a merchant never classified gets none | the agent proposes, you decide |
| Forecast | extends the last months, plus YNAB’s scheduled transactions; a quarterly or yearly charge without a schedule does not recur by its definition | schedule it in YNAB, or pass it as one_offs |
| Currency | amounts are shown as numbers, without a currency symbol | — |
| Python | 3.12 to 3.14; 3.15 waits on a dependency (beartype) | — |
Roadmap
Section titled “Roadmap”- A
.mcpbbundle for one-click install in Claude Desktop. - Undo for
update_category. - Lower the Python floor once dependencies allow.
- Run the evaluation through other clients than Claude Code, and with local models.
Missing something? Propose a feature.
Unofficial project. We are not affiliated, associated, or in any way officially connected with YNAB or any of its subsidiaries or affiliates. YNAB and You Need A Budget are registered trademarks of YNAB. avenir-mcp is provided as is, without warranty, and is not financial advice. Legal notice