YNAB CLI Manager for Openclaw

A comprehensive command-line interface for managing You Need A Budget (YNAB) data, including budgets, categories, and transactions.

obviyus
v1.0.0
Jan 5, 2026
8
3.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install ynab

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install ynab using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is YNAB CLI Manager?

The YNAB CLI skill is a powerful utility designed for developers and power users who want to interact with their personal finances programmatically. Built on the official API, this Openclaw Skills integration allows for seamless management of your financial life without the need for a GUI. It provides a bridge between your terminal and your budget, making it possible to query account balances, categorize transactions, and adjust monthly goals using simple commands.

By incorporating this skill into your workflow, you gain the ability to script financial updates and integrate your budget data into broader automation pipelines. This Openclaw Skills tool is essential for anyone looking to maintain a high level of financial discipline while leveraging the efficiency of a command-line environment.

YNAB CLI Manager Use Cases

  • Automating transaction entry and categorization via shell scripts.
  • Rapidly searching transaction history by payee or memo without opening a browser.
  • Bulk updating monthly category budgets during financial planning sessions.
  • Integrating real-time budget balances into custom developer dashboards or status bars.

How YNAB CLI Manager Works

  1. The skill connects to the YNAB API using a personal access token stored in your environment.
  2. Users select a target budget from their account to act as the primary context for future commands.
  3. CLI commands are issued to query various endpoints such as accounts, categories, or months.
  4. For write operations, the skill sends formatted JSON payloads to the API to create or update transactions and budget amounts.
  5. Response data is returned directly to the terminal, with optional flags for compact JSON formatting to facilitate further processing.

YNAB CLI Manager Setup

To get started with this Openclaw Skills integration, first install the CLI package:

npm i -g @stephendolan/ynab-cli

Next, obtain your API key from the YNAB developer settings (https://app.ynab.com/settings/developer) and authenticate your session:

# Set your API key as an environment variable
export YNAB_API_KEY='your_api_key_here'

# Or use the built-in login command
ynab auth login

YNAB CLI Manager Data Schema & Taxonomy

The skill interacts with the standard YNAB API objects. Below is the primary data structure managed by the CLI:

Entity Key Attributes
Budgets ID, Name, Last Modified, First Month
Accounts ID, Name, Type, Balance, Cleared Balance
Categories ID, Name, Budgeted Amount, Activity, Balance
Transactions ID, Date, Amount (in currency), Payee, Category, Memo, Cleared Status
Payees ID, Name, Transfer Account ID

Note: Amounts are handled in the budget's native currency format rather than milliunits for better readability.

YNAB CLI Manager Advanced Features

  • Direct API access via the raw command for executing custom GET and POST requests.
  • Support for complex split transactions using JSON arrays for detailed allocation.
  • Filtering and searching capabilities for transactions based on approval status, minimum amounts, or specific dates.
  • Management of scheduled transactions to preview upcoming financial commitments.
  • Compact output mode for lightweight integration with other CLI tools and scripts.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*