daniel156161
e115698e92
- Serialize property set and remove commands per vault note to avoid lost frontmatter writes. - Wait briefly for successful property writes to hit disk before releasing the note lock. - Return property path, name, value, type, operation, and ok status in n8n outputs. - Include property details on continue-on-fail errors so failed items are visible in n8n. - Bump obsidian-api to 1.0.7 and n8n-nodes-obsidian-cli-api to 0.2.8. - Add regression coverage for concurrent property writes to the same note.
n8n-nodes-obsidian-cli-api
n8n community-node package for the Obsidian API Docker service.
It talks to the HTTP API, which then runs the official Obsidian CLI against mounted vaults. The node sends structured args arrays only. It does not send shell commands.
Nodes
Obsidian API
Resources:
- Note
- Create
- Read
- Append
- Prepend
- Delete
- Rename
- List Files
- Property
- Set
- Read
- Remove
- List
- Daily Note
- Append
- Prepend
- Read
- Path
- Search
- Search
- Search With Context
- Vault
- Info
- List Vaults
- Raw Command
- Safe args-array escape hatch for any official CLI command
Credentials
Credential type: Obsidian API
Fields:
- Base URL: URL of your Obsidian API service, e.g.
http://localhost:8080 - API Token: JWT created with
scripts/create_jwt.py - Default Vault: optional, e.g.
work
Multi-vault
Set the Vault field on a node to override the credential default vault.
The node sends this as the official CLI prefix:
vault=work
Raw command example:
["vault=work", "read", "path=Inbox/Note.md"]
Properties / frontmatter
The official Obsidian CLI supports property/frontmatter commands. The n8n node exposes them as the Property resource:
- Set sends
property:set path=<note> name=<property> value=<value> type=<type> - Read sends
property:read path=<note> name=<property> - Remove sends
property:remove path=<note> name=<property> - List sends
properties name=<optional> format=<yaml|json|tsv>
Examples:
path=00 Kontext/Feedback Browser CLI Tests.md
name=tags
value=kontext, feedback-browser-cli-tests
type=list
path=00 Kontext/Feedback Browser CLI Tests.md
name=date
value=2026-06-24
type=date
Local install in self-hosted n8n
From this repo:
cd packages/n8n-nodes-obsidian-api
npm install --ignore-scripts
npm run build
npm pack
Then install the generated .tgz in your n8n custom extensions setup.
For Docker-based n8n, one common setup is mounting this package into n8n's custom extensions directory and setting:
N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom
Exact installation depends on your n8n deployment.
Development
npm install --ignore-scripts
npm run typecheck
npm run build
--ignore-scripts avoids local native builds from n8n transitive dependencies on unsupported bleeding-edge Node versions. Use the Node version recommended by your n8n release for production builds.