Read Note
readRead the full content of markdown documents or attachments by path. Returns frontmatter, title, and folder for .md files. Optionally read a specific section by heading.
Instructions
Read the full content of a document or attachment by path.
For .md documents: returns content (the full raw file including frontmatter), plus the parsed frontmatter, title, and folder. For attachments (pdf, png, etc.): returns base64-encoded binary content and MIME type. Use 'list_documents(include_attachments=True)' to discover attachment paths. Use 'stats' to see allowed extensions.
Do not guess paths — look them up first via 'search' or 'list_documents'.
To recover the full text of a specific section returned by 'search', pass section=heading (the value from the result's 'heading' field).
Context cost: every byte returned counts against the LLM's
context budget. Reads above MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES
(default 256 KB for .md) or
MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB (default 1 MB for
binaries) raise ValueError. For partial markdown reads, pass
section=heading (use the heading field from a search()
result).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Relative path to the document or attachment (e.g. "Journal/note.md" or "assets/diagram.pdf"). Case-sensitive. | |
| section | No | When provided, return the whole section whose heading matches *section* — every paragraph, list, and sub-section from the heading up to the next heading at the same or higher level (case-sensitive; internal whitespace is collapsed before comparison). Pass the ``heading`` value from a ``search`` result unchanged for guaranteed match. ``None`` (the default) returns the whole document. Ignored for non-.md paths. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||