# itensei/n8n-nodes-lunchmoney architecture

> Architecture diagram of the GitHub repository itensei/n8n-nodes-lunchmoney, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/itensei/n8n-nodes-lunchmoney
- Repository: https://github.com/itensei/n8n-nodes-lunchmoney

## Overview

This repository is an n8n community node that exposes Lunch Money’s personal-finance API as configurable workflow operations. An n8n workflow selects a resource and operation, the node builds a request and dispatches it through shared API helpers, and the response becomes workflow output. Resource descriptions define the UI options; the documented surface spans user, category, transaction, tag, recurring-item, budget, account, crypto, and balance-history operations. The excerpts show request dispatch and pagination, but not every resource handler; unsampled links are omitted.

Main entry points: [`nodes/LunchMoney/LunchMoney.node.ts`](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/LunchMoney.node.ts) (Operation executor), [`nodes/LunchMoney/GenericFunctions.ts`](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/GenericFunctions.ts) (API request helpers), [`credentials/LunchMoneyApi.credentials.ts`](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/credentials/LunchMoneyApi.credentials.ts) (API credentials), [`nodes/LunchMoney/descriptions/BudgetDescription.ts`](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/BudgetDescription.ts) (Budget operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Node runtime"]
  node_node["Operation executor<br/>[LunchMoney.node.ts]"]
  node_api_helpers["API request helpers"]
  node_credentials["API credentials"]
end

subgraph group_money["Money management"]
  node_budget["Budget operations"]
  node_transaction["Transaction operations"]
end

subgraph group_accounts["Accounts and balances"]
  node_manual_account["Manual account operations"]
  node_plaid_account["Plaid account operations"]
  node_crypto["Crypto operations"]
  node_balance_history["Balance history operations"]
end

subgraph group_organization["Finance organization"]
  node_user["User operations<br/>[UserDescription.ts]"]
  node_category["Category operations"]
  node_tag["Tag operations<br/>[TagDescription.ts]"]
  node_recurring["Recurring item operations"]
end

node_workflow(("n8n workflow"))
node_lunch_money_api{{"Lunch Money API"}}
node_mock_api{{"Mock API"}}

node_workflow -->|"executes"| node_node
node_node -->|"dispatches requests"| node_api_helpers
node_api_helpers -->|"loads credential"| node_credentials
node_api_helpers -->|"sends requests"| node_lunch_money_api
node_api_helpers -.->|"can target"| node_mock_api
node_node -->|"uses operation definitions"| node_user
node_node -->|"uses operation definitions"| node_category
node_node -->|"uses operation definitions"| node_transaction
node_node -->|"uses operation definitions"| node_tag
node_node -->|"uses operation definitions"| node_recurring
node_node -->|"uses operation definitions"| node_budget
node_node -->|"uses operation definitions"| node_manual_account
node_node -->|"uses operation definitions"| node_plaid_account
node_node -->|"uses operation definitions"| node_crypto
node_node -->|"uses operation definitions"| node_balance_history

click node_node "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/LunchMoney.node.ts"
click node_api_helpers "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/GenericFunctions.ts"
click node_credentials "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/credentials/LunchMoneyApi.credentials.ts"
click node_user "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/UserDescription.ts"
click node_category "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/CategoryDescription.ts"
click node_tag "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/TagDescription.ts"
click node_recurring "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/RecurringItemDescription.ts"
click node_budget "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/BudgetDescription.ts"
click node_transaction "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/TransactionDescription.ts"
click node_manual_account "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/ManualAccountDescription.ts"
click node_plaid_account "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/PlaidAccountDescription.ts"
click node_crypto "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/CryptoDescription.ts"
click node_balance_history "https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/BalanceHistoryDescription.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_node,node_api_helpers,node_credentials toneBlue
class node_budget,node_transaction toneAmber
class node_manual_account,node_plaid_account,node_crypto,node_balance_history,node_lunch_money_api,node_mock_api toneMint
class node_user,node_category,node_tag,node_recurring toneRose
class node_workflow toneIndigo
```

## Components

### Node runtime

- [Operation executor](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/LunchMoney.node.ts): `nodes/LunchMoney/LunchMoney.node.ts`
- [API request helpers](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/GenericFunctions.ts): `nodes/LunchMoney/GenericFunctions.ts`
- [API credentials](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/credentials/LunchMoneyApi.credentials.ts): `credentials/LunchMoneyApi.credentials.ts`

### Money management

- [Budget operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/BudgetDescription.ts): `nodes/LunchMoney/descriptions/BudgetDescription.ts`
- [Transaction operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/TransactionDescription.ts): `nodes/LunchMoney/descriptions/TransactionDescription.ts`

### Accounts and balances

- [Manual account operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/ManualAccountDescription.ts): `nodes/LunchMoney/descriptions/ManualAccountDescription.ts`
- [Plaid account operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/PlaidAccountDescription.ts): `nodes/LunchMoney/descriptions/PlaidAccountDescription.ts`
- [Crypto operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/CryptoDescription.ts): `nodes/LunchMoney/descriptions/CryptoDescription.ts`
- [Balance history operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/BalanceHistoryDescription.ts): `nodes/LunchMoney/descriptions/BalanceHistoryDescription.ts`

### Finance organization

- [User operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/UserDescription.ts): `nodes/LunchMoney/descriptions/UserDescription.ts`
- [Category operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/CategoryDescription.ts): `nodes/LunchMoney/descriptions/CategoryDescription.ts`
- [Tag operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/TagDescription.ts): `nodes/LunchMoney/descriptions/TagDescription.ts`
- [Recurring item operations](https://github.com/itensei/n8n-nodes-lunchmoney/blob/main/nodes/LunchMoney/descriptions/RecurringItemDescription.ts): `nodes/LunchMoney/descriptions/RecurringItemDescription.ts`

### Other components

- **n8n workflow**
- **Lunch Money API**
- **Mock API**

## Connections

- n8n workflow → Operation executor: executes (evidence: `README.md`)
- Operation executor → API request helpers: dispatches requests (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- API request helpers → API credentials: loads credential (evidence: `nodes/LunchMoney/GenericFunctions.ts`)
- API request helpers → Lunch Money API: sends requests (evidence: `nodes/LunchMoney/GenericFunctions.ts`)
- API request helpers → Mock API: can target (evidence: `README.md`)
- Operation executor → User operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Category operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Transaction operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Tag operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Recurring item operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Budget operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Manual account operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Plaid account operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Crypto operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
- Operation executor → Balance history operations: uses operation definitions (evidence: `nodes/LunchMoney/LunchMoney.node.ts`)
