ynab
Manage YNAB budgets, accounts, categories, and transactions via CLI.
When & Why to Use This Skill
This Claude skill enables seamless management of YNAB (You Need A Budget) data, allowing users to interact with budgets, accounts, categories, and transactions via a CLI. It streamlines financial tracking by providing tools for real-time transaction logging, budget status checks, and detailed financial data retrieval directly within an AI-powered workflow, making it an essential tool for automated personal or small business finance management.
Use Cases
- Automated Transaction Entry: Quickly record new expenses or income by specifying accounts, amounts, and categories through simple text commands without manual app entry.
- Real-time Budget Auditing: Instantly check category balances and monthly budget limits to make informed spending decisions on the fly.
- Transaction Analysis and Search: Efficiently locate specific transactions by memo, payee, or date range to reconcile accounts or track historical spending patterns.
- Bulk Financial Management: Perform complex operations like splitting transactions or updating multiple entries across different budgets using automated scripts or AI assistance.
| 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 <id>
Accounts
ynab accounts list
ynab accounts view <id>
ynab accounts transactions <id>
Categories
ynab categories list
ynab categories view <id>
ynab categories transactions <id>
ynab categories budget <id> --month <YYYY-MM> --amount <amount>
Transactions
ynab transactions list
ynab transactions list --account <id> --since <YYYY-MM-DD>
ynab transactions list --approved=false --min-amount 100
ynab transactions search --memo "coffee"
ynab transactions search --payee-name "Amazon"
ynab transactions view <id>
ynab transactions create --account <id> --amount <amount> --date <YYYY-MM-DD>
ynab transactions update <id> --amount <amount>
ynab transactions delete <id>
ynab transactions split <id> --splits '[{"amount": -50.00, "category_id": "xxx"}]'
Payees
ynab payees list
ynab payees view <id>
ynab payees update <id> --name <name>
ynab payees transactions <id>
Months
ynab months list
ynab months view <YYYY-MM>
Scheduled
ynab scheduled list
ynab scheduled view <id>
ynab scheduled delete <id>
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
--compactfor minified JSON - Rate limit: 200 req/hour
- Cannot create categories/groups/payees via API