Skip to content
MCP server

Avenir MCP

Unofficial read-first MCP server for YNAB with previewed, undoable changes

Runs locallyStatus and history
Install
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-mcp

Add 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).Required
  • AVENIR_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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government