Manage YNAB budgets, accounts, categories, and transactions.

---

name: ynab description: Manage YNAB budgets, accounts, categories, and transactions via CLI. metadata: {"clawdbot":{"emoji":"💰","requires":{"bins":["ynab"],"env":["YNAB_API_KEY"]},"primaryEnv":"YNAB_API_KEY","install":[{"id":"node","kind":"node","package":"@stephendolan/ynab-cli","bins":["ynab"],"label":"Install ynab-cli (npm)"}]}}

---

YNAB CLI

Install

npm i -g @stephendolan/ynab-cli

Auth

# Get API key from https://app.ynab.com/settings/developer
Then set YNAB_API_KEY env var, or:
ynab auth login
ynab auth status

Budgets

ynab budgets list
ynab budgets view [id]
ynab budgets set-default 

Accounts

ynab accounts list
ynab accounts view 
ynab accounts transactions 

Categories

ynab categories list
ynab categories view 
ynab categories transactions 
ynab categories budget  --month  --amount 

Transactions

ynab transactions list
ynab transactions list --account  --since 
ynab transactions list --approved=false --min-amount 100
ynab transactions search --memo "coffee"
ynab transactions search --payee-name "Amazon"
ynab transactions view 
ynab transactions create --account  --amount  --date 
ynab transactions update  --amount 
ynab transactions delete 
ynab transactions split  --splits '[{"amount": -50.00, "category_id": "xxx"}]'

Payees

ynab payees list
ynab payees view 
ynab payees update  --name 
ynab payees transactions 

Months

ynab months list
ynab months view 

Scheduled

ynab scheduled list
ynab scheduled view 
ynab scheduled delete 

Raw API

ynab api GET /budgets
ynab api POST /budgets/{budget_id}/transactions --data '{"transaction": {...}}'

Notes

Amounts are in your budget's currency, not milliunits

Use --compact for minified JSON

Rate limit: 200 req/hour

Cannot create categories/groups/payees via API