Create Note Or Folder
notes.createCreate notes and folders in an Obsidian vault. Specify note path and content; choose error, replace, or skip if exists. Folders are idempotent. Works with active vault or explicit path.
Instructions
Create a new note or folder in the vault. kind:'note' creates a markdown note at path with the given content; ifExists controls collision behavior (error = fail, default; replace = overwrite; skip = no-op). kind:'folder' creates a directory at path (intermediate folders are created automatically; idempotent — re-creating an existing folder is a no-op). Returns the standard mutation envelope.
Operates on the session-active vault (see vault.current — selectable via vault.select) unless an explicit vaultPath argument is passed, which always wins.
Examples:
Example 1 — Create a new note, failing if it exists:
{
"kind": "note",
"path": "Journal/2026-04-24.md",
"content": "# Today\n"
}Example 2 — Ensure a folder exists (idempotent):
{
"kind": "folder",
"path": "Projects/Alpha/Reports"
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| changed | Yes | True if the tool altered vault state on this call; false if it was a no-op. | |
| target | Yes | The path or identifier the tool acted on. | |
| summary | Yes | Short human-readable summary of what happened. |