Avenir MCP
Unofficial read-first MCP server for YNAB with previewed, undoable changes
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.8.0
- Listing updated
- 2 days ago
About Avenir MCP
Avenir MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Avenir-mcp is an open-source server for YNAB budgets, listed in YNAB's Works with YNAB directory but not endorsed by it. It exposes 17 task-shaped tools rather than raw API endpoints, so one tool classifies a month of transactions, reconciles an account or forecasts a balance. A local copy of your transactions refreshed by delta sync means most tools use one or two of YNAB's 200 requests per hour, and amounts come back in currency units rather than milliunits.
It is read-only by default: the thirteen write tools are not even listed until you set AVENIR_MCP_WRITE=1. Every change is previewed, confirmed by you in the client or with a one-time code, and journaled so it can be undone without overwriting later work. You supply a YNAB personal access token as YNAB_API_KEY.
Example questions include which category is overspent, whether the balance will go below zero before December, when debts will be paid off at 500 a month, and moving 30 from one category to another. It installs from PyPI with uvx or as a Claude Desktop extension, and the project reports 100% line and branch coverage.
Install
Run in a terminal
claude mcp add avenir-mcp --env YNAB_API_KEY='<YNAB_API_KEY>' -- uvx avenir-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"avenir-mcp": {
"command": "uvx",
"args": [
"avenir-mcp"
],
"env": {
"YNAB_API_KEY": "<YNAB_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"avenir-mcp": {
"command": "uvx",
"args": [
"avenir-mcp"
],
"env": {
"YNAB_API_KEY": "<YNAB_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"avenir-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"avenir-mcp"
],
"env": {
"YNAB_API_KEY": "<YNAB_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"avenir-mcp": {
"command": "uvx",
"args": [
"avenir-mcp"
],
"env": {
"YNAB_API_KEY": "<YNAB_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"avenir-mcp": {
"command": "uvx",
"args": [
"avenir-mcp"
],
"env": {
"YNAB_API_KEY": "<YNAB_API_KEY>"
}
}
}
}Configuration
YNAB_API_KEYYour YNAB personal access token (YNAB > Account settings > Developer settings).RequiredAVENIR_MCP_WRITESet to 1 to expose the write tools; read-only otherwise.
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- get_budget_vs_actual
- Budgeted, spent and left for every category
- get_monthly_summary
- Summary of a month
- forecast_balance
- Forecasts the balance
- get_debt_payoff_plan
- Plans debt payoff
- suggest_categories
- Suggests categories for transactions
- find_transactions
- Finds a transaction
- reconcile_account
- Reconciles an account with the bank
- move_money
- Moves money between categories
- undo_operation
- Undoes an applied change
What it does
- Task-shaped tools
- 17 tools each handle a whole job such as reconciling an account.
- Read-only by default
- Write tools stay hidden until you enable them.
- Preview, confirm, undo
- Changes are previewed, confirmed and journaled for undo.
- Debt payoff and forecasts
- Projects balances and debt payoff plans.
- Quota-friendly sync
- Local transaction copy keeps YNAB requests low.
- Typed outputs
- Currency units and field descriptions agents can read.
Good for
- Find which budget category is overspent
- Forecast whether the balance dips below zero
- Categorise pending transactions
- Reconcile an account against bank balance
- Plan debt payoff with a monthly amount
Pricing
Open source
Free and open source; requires your own YNAB subscription
Prices change. Check avenir-mcp.pages.dev before you buy.
Avenir MCP FAQ
Can it change my budget by default?
No. Write tools are not available until AVENIR_MCP_WRITE=1 is set.
Can changes be reversed?
Yes. Applied changes are journaled and can be undone without overwriting later work.
What credential is needed?
A YNAB personal access token supplied as YNAB_API_KEY.
Is it official?
No. It is unofficial and not endorsed by YNAB.
Is Avenir MCP free?
Yes. Avenir MCP is open source, so you can use and self-host it for free.
How do I add Avenir MCP to Claude Code?
Run this command in your terminal: claude mcp add avenir-mcp --env YNAB_API_KEY='<YNAB_API_KEY>' -- uvx avenir-mcp
What are the best alternatives to Avenir MCP?
The closest alternatives to Avenir MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to Avenir MCP

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government