actual-budget
by thisisjeron
Productivity & TasksBrief
Query and manage personal finances via the official Actual.
Description
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
User asks: What were my top 5 spending categories in January 2026?
- 1
Initialize the Actual Budget API with server URL, password, and sync ID
- 2
Download the budget using the configured sync ID
- 3
Run an ActualQL query filtering January transactions with negative amounts, grouped by category name
- 4
Sort results by total and take the top 5 entries
- 5
Shut down the API and return the formatted category totals
Top 5 spending categories for January 2026 with dollar totals
Requirements
- Self-hosted Actual Budget server instance
- ACTUAL_SERVER_URL environment variable
- ACTUAL_PASSWORD environment variable
- ACTUAL_SYNC_ID environment variable (found in Settings → Advanced → Sync ID)
Installation
clawhub install thisisjeron/actual-budgetRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.