Agent skill

ynab

Manage YNAB budgets, accounts, categories, and transactions via CLI.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/ynab

Metadata

Additional technical details for this skill

clawdbot 
{
    "emoji": "\ud83d\udcb0",
    "install": [
        {
            "id": "node",
            "bins": [
                "ynab"
            ],
            "kind": "node",
            "label": "Install ynab-cli (npm)",
            "package": "@stephendolan/ynab-cli"
        }
    ],
    "requires": {
        "env": [
            "YNAB_API_KEY"
        ],
        "bins": [
            "ynab"
        ]
    },
    "primaryEnv": "YNAB_API_KEY"
}

SKILL.md

YNAB CLI

Install

bash
npm i -g @stephendolan/ynab-cli

Auth

bash
# 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

bash
ynab budgets list
ynab budgets view [id]
ynab budgets set-default <id>

Accounts

bash
ynab accounts list
ynab accounts view <id>
ynab accounts transactions <id>

Categories

bash
ynab categories list
ynab categories view <id>
ynab categories transactions <id>
ynab categories budget <id> --month <YYYY-MM> --amount <amount>

Transactions

bash
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

bash
ynab payees list
ynab payees view <id>
ynab payees update <id> --name <name>
ynab payees transactions <id>

Months

bash
ynab months list
ynab months view <YYYY-MM>

Scheduled

bash
ynab scheduled list
ynab scheduled view <id>
ynab scheduled delete <id>

Raw API

bash
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

Didn't find tool you were looking for?

Be as detailed as possible for better results