Description

n8n-nodes-actual

This is a n8n community node. It lets you use Actual in your n8n workflows.

Actual is a local-first personal finance tool. It is 100% free and open-source, written in NodeJS, it has a synchronization element so that all your changes can move between devices without any heavy lifting.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Resources
License

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

• Get Budget Month — retrieve budget data (income, spending, balances per category) for a given month
• Get Transactions — fetch transactions from an account within a date range
• Import Transactions — import a list of transactions into an account
• Set Budget Amount — set the budgeted amount for a category in a given month

Credentials

The URL and the password of your actual server, plus:

• Budget ID: the budget this credential works with. Used by node version 3 (the default for new nodes), which has no Budget ID field of its own, so create one credential per budget.
• End-to-End Encryption Password: only if that budget uses end-to-end encryption. This is the password you set for the budget, not the server password. Without it, Actual reports File is encrypted. Please provide a password. Leave it empty for unencrypted budgets.

Because the budget and its encryption password live together in the credential, budgets with different encryption passwords (or a mix of encrypted and unencrypted budgets) work side by side.

Existing workflows keep working: nodes saved with version 1 or 2 still take the Budget ID from the node itself. For those versions the optional encryption password also applies, but to whichever budget the node names, so a single credential can’t serve budgets with different passwords there. Recreate the node (version 3) to get one credential per budget.

Compatibility


Last tested with n8n 2.47.3 and Actual 26.11.0.


Versioning

The package version mirrors the Actual it was last tested with: major.minor is Actual’s, so 26.10.x goes with Actual 26.10. The patch number is this package’s own counter.

• Every change to the node, including breaking ones, only bumps the patch. Breaking changes are called out in the release notes, not in the version number. Read the notes before updating.
• When Actual’s major or minor version changes, the next release is ..0, after the nightly compatibility check has passed against the new Actual.

Resources

• n8n community nodes documentation
• Actual Budget Website

License

MIT, see LICENSE.md.

Community node packages can’t declare native-addon or shared-library runtime
dependencies, so a few third-party packages (@actual-app/api, better-sqlite3,
detect-libc, and their own dependencies) are bundled directly into this package’s
build output rather than installed normally — see
THIRD-PARTY-NOTICES.md for their license terms.