YNAB

Budget tracking from chat -- view budgets, accounts, categories, transactions, payees, and scheduled recurring transactions.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted OAuth flows and credentials so you don't need to configure YNAB API access yourself.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect YNAB
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect YNAB

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   YNAB API       │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

1. List your budgets: ynab_list_budgets -- discover budget IDs.
2. View accounts: ynab_list_accounts -- see all accounts with balances.
3. Check transactions: ynab_list_transactions -- review recent spending.

Authentication

YNAB uses managed OAuth via ClawLink. No API keys needed. Connect your YNAB account at claw-link.dev/dashboard?add=ynab and authorize access through the hosted flow.

Connection Management

List connections: clawlink_list_integrations -- confirm YNAB is connected.

Verify: Call ynab_list_budgets to test access.

Reconnect: If you see auth errors, reconnect at claw-link.dev/dashboard?add=ynab.

Security & Permissions

Read operations (list budgets, transactions, categories) run safely. Write operations (create accounts, update payees) require confirmation. Delete operations for scheduled transactions are high-impact and irreversible.

Tool Reference

Budget Operations

Account Operations

Category Operations

Transaction Operations

Scheduled Transaction Operations

Payee Operations

Payee Location Operations

User Operations

Code Examples

List budgets and check balances

{ "tool": "ynab_list_budgets" }

{
  "tool": "ynab_list_accounts",
  "args": { "budget_id": "last-used" }
}

List recent transactions

{
  "tool": "ynab_list_transactions",
  "args": {
    "budget_id": "last-used",
    "since_date": "2026-06-01"
  }
}

Check a specific month's budget

{
  "tool": "ynab_get_budget_month",
  "args": {
    "budget_id": "last-used",
    "month": "2026-06-01"
  }
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm ynab is connected.
2. Call clawlink_list_tools --integration ynab to see the live catalog.
3. Call ynab_list_budgets to get your budget ID (or use "last-used" / "default").
4. Use the budget ID for all subsequent operations.

Execution Workflow

Read Flow:  User asks for budget info → clawlink resolves connection → YNAB API → results displayed
Write Flow: User wants to create acct → confirmation prompt → clawlink resolves connection → YNAB API → account created

Notes

• Currency amounts are in milliunits format. Divide by 1000 for standard units (e.g., 150000 = $150.00).
• Use "last-used" or "default" as budget_id for convenience instead of the full UUID.
• ynab_get_budget_by_id returns a complete export and may be large. Prefer specific list endpoints.
• Use last_knowledge_of_server for incremental/delta syncing.
• Category names may include emojis; always use category_id for downstream requests.

Error Handling

Troubleshooting

Tools Not Visible

Run openclaw gateway restart after installing the plugin. Start a fresh chat session.

Large Transaction Lists

Use since_date, type, or last_knowledge_of_server to scope results and avoid large payloads.

Resources

• YNAB API Docs: https://api.ynab.com
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=ynab
• ClawLink Docs: https://docs.claw-link.dev/openclaw

Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=ynab) -- an integration hub for OpenClaw