Skip to content
TakoAPI
Back to skills

actual-budget

by thisisjeron

Productivity & Tasks
3.0kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

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

AGENT
  1. 1

    Initialize the Actual Budget API with server URL, password, and sync ID

  2. 2

    Download the budget using the configured sync ID

  3. 3

    Run an ActualQL query filtering January transactions with negative amounts, grouped by category name

  4. 4

    Sort results by total and take the top 5 entries

  5. 5

    Shut down the API and return the formatted category totals

OUTPUT

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-budget

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links