← Back to Skills Marketplace
Actual Budget
by
Jeron Wong
· GitHub ↗
· v1.0.4
· MIT-0
4683
Downloads
2
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install actual-budget
Description
Query and manage personal finances via the official Actual Budget Node.js API. Use when handling budget queries, transaction imports/exports, account managem...
Usage Guidance
Install only if you trust the environment where Node.js will run and you are comfortable giving it access to your Actual Budget instance. Store credentials outside chat and repositories, back up your budget, and require clear confirmation before imports, account changes, rules, schedules, bank sync, or `api.sync()`.
Capability Analysis
Type: OpenClaw Skill
Name: actual-budget
Version: 1.0.4
The skill provides a legitimate interface for the Actual Budget Node.js API, following security best practices such as environment variable usage for credentials and explicit instructions to redact sensitive financial data. It correctly points to the official `@actual-app/api` package and includes safeguards against common risks like TLS disabling or remote script execution in SKILL.md.
Capability Assessment
Purpose & Capability
The stated purpose matches the artifact: it uses the official Actual Budget Node.js API for budget queries, imports, account management, categories, rules, schedules, bank sync, and syncing changes. These are sensitive financial capabilities, but they are disclosed and purpose-aligned.
Instruction Scope
The skill instructs the agent to distinguish read-only from mutating work, summarize intended changes before writes unless already approved, sync only after changes, shut down the API, and redact secrets and sensitive financial output.
Install Mechanism
Installation is limited to the official `@actual-app/api` npm package and explicitly warns against similarly named packages, remote script execution, and disabling TLS. The dependency is not pinned, and `_meta.json` shows version 1.0.2 while registry metadata says 1.0.4, which is a provenance note but not evidence of harmful behavior.
Credentials
The required Actual server URL, password, sync ID, and optional encryption password are sensitive but necessary for this integration. The skill directs users to keep credentials outside the skill and load them from the runtime environment.
Persistence & Privilege
The skill uses a local Actual data cache and suggests a private credentials file with strict permissions. No hidden background worker, automatic persistence beyond the disclosed cache, privilege escalation, or unrelated file access is shown.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install actual-budget - After installation, invoke the skill by name or use
/actual-budget - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
Avoid static scanner false positive around encryption password example.
v1.0.3
Clean up security-scan false positives and tighten credential-handling guidance.
v1.0.2
Security: Removed NODE_TLS_REJECT_UNAUTHORIZED=0 recommendation. Added proper guidance for self-signed certificates using NODE_EXTRA_CA_CERTS instead.
v1.0.1
- Expanded documentation from CLI tool usage to **official Node.js API usage**
- Updated environment variables and setup instructions for clarity and additional options.
- Added code examples for all major financial operations (budget overview, account/transaction/category/payee management, rules, schedules, sync).
- Introduced ActualQL query support with example queries and available operators.
- Included advanced topics: handling transfers, split transactions, and bulk imports for new budgets.
- Linked to full API and query language documentation for further reference. usi
v1.0.0
Initial release of actual-budget skill for managing personal finances.
- Connects to self-hosted Actual Budget instances via CLI.
- Supports importing/exporting transactions, auto-categorization, and bank statement parsing.
- Allows customization through config.js for accounts, categories, and custom parsers.
- Includes built-in support for multiple bank formats.
- Provides safety confirmation for destructive actions like deleting all transactions.
Metadata
Frequently Asked Questions
What is Actual Budget?
Query and manage personal finances via the official Actual Budget Node.js API. Use when handling budget queries, transaction imports/exports, account managem... It is an AI Agent Skill for Claude Code / OpenClaw, with 4683 downloads so far.
How do I install Actual Budget?
Run "/install actual-budget" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Actual Budget free?
Yes, Actual Budget is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Actual Budget support?
Actual Budget is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Actual Budget?
It is built and maintained by Jeron Wong (@thisisjeron); the current version is v1.0.4.
More Skills