This repository contains a custom node for n8n, an open-source workflow automation tool. The node integrates with Firefly III, a self-hosted personal finance manager.
It might not be the most advanced n8n node, built it for me while learning - so feel free to take it forward if needed.
Many of Firefly III endpoints implemented, including transactions, search and export - I believe it could help building many interesting workflows in n8n that automates finanance management even more.
This node supports many of Firefly III API endpoints, such as:
- /api/v1/transactions: Create, list, update, and delete transactions.
- /api/v1/accounts: Retrieve, create, update, and delete account details.
- /api/v1/budgets: Fetch budget information.
- /api/v1/categories: List, create, update, and delete categories.
- /api/v1/tags: Retrieve, create, update, and delete tags.
- /api/v1/attachments: Upload and manage attachments.
- /api/v1/recurrences: Handle recurring transactions.
- /api/v1/rules: Manage rules and rule groups.
- /api/v1/piggy_banks: Retrieve and manage piggy banks.
- /api/v1/preferences: Fetch user preferences.
- /api/v1/about: Retrieve system and user information.
- /api/v1/cron: Run cron jobs.
Note: it doesn't do crazy things, mostly one-to-one endpoint mapping, feel free to clone repo and do what you must.
- Open your n8n instance.
- Create a new workflow.
- Add the Firefly III node to your workflow.
- Configure the node with your Firefly III API credentials.
- Select the desired operation (e.g., Create Transaction, Retrieve Accounts).
- Execute the workflow to automate your personal finance tasks.
To use this node, you need to configure it with your Firefly III API credentials. You can obtain these credentials from your Firefly III instance.
- Log in to your Firefly III instance.
- Navigate to the API section.
- Create a new API token.
- Copy the token and paste it into the n8n Firefly III node configuration.
This project is licensed under the MIT License. See the LICENSE file for details.