mathbeal/avenir-mcp

Self-checked on every change against YNAB's API terms of 2025-05-28 (naming, attribution,
YNAB's own image, a personal token for its owner only, the hourly limit); a weekly job
turns the badge red when YNAB changes its terms. Listed by YNAB in its
Works with YNAB directory, among
third-party apps. Not endorsed by YNAB.
Built and tested against YNAB's API v1.87.0. A weekly YNAB API drift check compares it with the live specification and fails when YNAB publishes a new version.
> 🇬🇧 **avenir-mcp** (*avenir* is French for *the future*) lets an AI agent read your YNAB plan
> and help you plan what comes next.
>
> 🇫🇷 **avenir-mcp** permet à un agent IA de lire votre plan YNAB et de vous aider
> à préparer la suite.
Ask Claude — or any MCP client — about your plan
in plain words: where the money went, what still needs a category, whether an account
matches the bank, when money would run out. Every change is previewed, confirmed by
you, and can be undone.
**📖 Documentation: **
English · Français · Español · Deutsch · Nederlands
All four come from the invented demo plan: the write above is replayed by python -m docsgen,
so every line of it is what avenir-mcp answers today; then a real reply of Claude Sonnet, and
the net worth and the forecast the documentation shows. The demo plays for thirty seconds and
holds its last frame, which tells the whole story on its own: a reader whose system asks for
less motion, or a viewer that does not animate, sees that frame instead.
> **Unofficial project.** We are not affiliated, associated, or in any way officially
> connected with YNAB or any of its subsidiaries or affiliates. The official YNAB website
> can be found at https://www.ynab.com. The names YNAB and You Need A Budget, as well as
> related names, tradenames, marks, trademarks, emblems, and images are registered
> trademarks of YNAB. They are named here only to say which service avenir-mcp works with.
>
> avenir-mcp is for **personal use on your own machine, with your own YNAB token**. Running it
> as a public or shared server is not supported. It is provided as is, without warranty,
> and is not financial advice: you remain responsible for the changes you confirm. See the
> legal notice.
Why avenir-mcp
- **Tools for tasks, not endpoints.** Classify a month of transactions, reconcile an
account, forecast your balance: one tool each, not a wrapper of YNAB's API.
- **Read-only by default.** Tools that change your plan exist only when you enable
them.
- **Preview, confirm, undo.** Every write shows what will change and waits for your
yes; undo_operation reverts it.
- **Answers an agent can read.** Currency units, short typed answers, pagination,
errors that say what to fix, bank text treated as untrusted.
- **Verified.** 100 % line and branch coverage, and an evaluation where a real agent
works on an invented plan: 25/25 tasks.
Install
You need uv and a YNAB personal access token
(YNAB → Account Settings → Developer Settings → New Token).
One click installs avenir-mcp **read-only**: VS Code asks for your token in a password box and keeps it in its secret