LaunchKit · 2026
Back to Skills

actual-budget

Query and manage personal finances via the official Actual.

1
3.0k downloads
by @thisisjeron

Setup & Installation

openclaw skills install @thisisjeron/actual-budget

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install actual-budget

Version History

v1.0.2Feb 8, 2026 - Version note by skill developer:

Security: Removed NODE_TLS_REJECT_UNAUTHORIZED=0 recommendation. Added proper guidance for self-signed certificates using NODE_EXTRA_CA_CERTS instead.

What This Skill Does

Connects to a self-hosted Actual Budget instance via the official Node.js API. Supports querying budgets and transactions, importing bank data, managing accounts and categories, creating rules and schedules, and running bank sync. Runs headless against local budget data synced from your server.

Runs headless against synced local data, enabling fully automated finance workflows without opening the Actual Budget UI.

When to use it

  • Import last week's bank transactions into Actual Budget
  • Query total spending per category for a given month
  • Create auto-categorization rules for recurring payees
  • Set up a monthly bill schedule for a subscription
  • Check account balances across all tracked accounts

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: What were my top 5 spending categories in January 2026?

AGENT
  1. 1Initialize the Actual Budget API with server URL, password, and sync ID
  2. 2Download the budget using the configured sync ID
  3. 3Run an ActualQL query filtering January transactions with negative amounts, grouped by category name
  4. 4Sort results by total and take the top 5 entries
  5. 5Shut down the API and return the formatted category totals
OUTPUT

Top 5 spending categories for January 2026 with dollar totals

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Self-hosted Actual Budget server instanceACTUAL_SERVER_URL environment variableACTUAL_PASSWORD environment variableACTUAL_SYNC_ID environment variable (found in Settings → Advanced → Sync ID)