lunchmoney-v2

n8n community node for the Lunch Money v2 API — manage transactions, budgets, categories, accounts and more.

Package Information

Downloads: 2 weekly / 48 monthly
Latest Version: 0.9.0
Author: brunofelixns

Documentation

n8n-nodes-lunchmoney-v2

npm version
License: MIT

An n8n community node for the Lunch Money v2 API — the next-generation alpha API for the personal budget manager Lunch Money.

Note: The Lunch Money v2 API is currently in alpha and may be subject to change. See the migration guide from v1 if you are coming from the previous version.


Available Resources

The node exposes 22 endpoints grouped into the following resources:

Resource Description
me View details and settings for the current user
categories Create, read, update and delete categories
manual_accounts Manage manually managed accounts (formerly called assets)
plaid_accounts Accounts synced through Plaid
recurring_items Work with recurring items
tags Manage tags
transactions Create, read, update and delete transactions
transactions (bulk) Perform bulk actions on transactions
transactions (group) Group and ungroup transactions
transactions (split) Split and unsplit transactions
transactions (files) Manage files attached to transactions
budgets View and modify budget amounts
summary View a summary of the user's budget

Installation

From n8n (recommended)

  1. Open n8n and go to Settings → Community nodes.
  2. Click Install a community node.
  3. Enter n8n-nodes-lunchmoney-v2 and confirm.

From npm (self-hosted instance)

npm install n8n-nodes-lunchmoney-v2

Restart n8n after installing.


Authentication

This node uses Bearer token authentication.

  1. Generate your personal API token at https://my.lunchmoney.app/developers.
  2. In n8n, create a credential of type Lunch Money V2 API.
  3. Paste the token in the API Token field.

n8n will automatically verify the credential against the /me endpoint.


Available Servers

Server URL Description
Production https://api.lunchmoney.dev/v2 Affects real data
Static mock https://mock.lunchmoney.dev/v2 For testing without a real token

When using the mock server, any string of 11+ characters works as a token.


How It Works

This node uses @devlikeapro/n8n-openapi-node to generate the entire n8n UI directly from the Lunch Money OpenAPI 3.0 document. There is no manual execute() function — n8n handles HTTP calls declaratively from the spec.


Local Development

git clone https://github.com/brunofelixns/n8n-lunchmoney-v2-node.git
cd n8n-lunchmoney-v2-node
npm install
npm run build

To link the node to a local n8n instance:

npm link
cd /path/to/your/n8n
npm link n8n-nodes-lunchmoney-v2

Useful Links


License

MIT

Discussion