Read Note
notes.readRead-onlyIdempotent
Retrieve a note's body, frontmatter metadata, and statistics such as word counts and links from an Obsidian vault by providing its path. Select which sections to include for efficient access.
Instructions
Read a note and return any combination of its body, parsed frontmatter metadata, and lightweight statistics. include selects which sections to return — default is ['content', 'metadata']. Ask for ['stats'] alone when you only need word/character/heading/link/task counts and want to skip loading the full body. Read-only. Fails with not_found when path does not exist.
Operates on the session-active vault (see vault.current — selectable via vault.select) unless an explicit vaultPath argument is passed, which always wins.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Vault-relative note path. | |
| include | No | Which sections to return. `content` = full body; `metadata` = parsed frontmatter and basic info; `stats` = word count, character count, heading count, link count, task count. Omit to get content + metadata. | |
| vaultPath | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| content | No | ||
| metadata | No | ||
| stats | No |