Skip to main content
Glama

Engram Obsidian Memory Sync

Read Notes

get_notes
Read-onlyIdempotent

Retrieve the full content of multiple notes in one call (1-20 paths). Also reads a single note: pass one path. Use to inventory a folder (list_folder then get_notes) or to read a batch of search results without N round-trips. Missing paths are reported inline. To save tokens on long notes, pass outline: true for the heading list only, or section with one path to read just that heading's section. Pass include_links: true to also get, per note, the notes linking to it, the notes it links to, and its links that point at no existing note.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pathsYesNote paths to read (max 20), e.g. ["Health/A.md", "Health/B.md"]
outlineNotrue returns each note's headings (level and text) instead of its content
sectionNoHeading text without the # prefix, e.g. "Todo". Returns only that section (heading line included, subsections included). One path only.
vault_idNoTarget vault: its name (e.g. "Engram") or its UUID. REQUIRED when you own more than one vault; the server keeps no active-vault state between calls, so it must be passed on every vault-scoped call. Omit only if you have a single vault. Call list_vaults if a name does not resolve.
include_linksNotrue adds backlinks, outgoing and unresolved link lists to each found note

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
notesYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / notes / items / properties / error / description
      Previous value: -"Only with outline: true, when this note's outline could not be computed: server busy, the call ran out of time, the note is too complex to parse, parsing failed, or the note has invalid UTF-8. Outline omitted"New value: +"Content or outline absent. With outline: true, the outline could not be computed: server busy, the call ran out of time, the note is too complex to parse, parsing failed, or the note has invalid UTF-8. Otherwise the call's 4 MB content budget was spent by earlier notes: fetch this one in its own call"
  2. Changed10 schema fields changed
    • addedInput schema / properties / include_links
      Added value: +{
      +  "default": false,
      +  "description": "true adds backlinks, outgoing and unresolved link lists to each found note",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / outline
      Added value: +{
      +  "default": false,
      +  "description": "true returns each note's headings (level and text) instead of its content",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / section
      Added value: +{
      +  "description": "Heading text without the # prefix, e.g. \"Todo\". Returns only that section (heading line included, subsections included). One path only.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / notes / items / properties / backlinks
      Added value: +{
      +  "description": "Paths of notes linking to this one (include_links)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / notes / items / properties / content / description
      Added value: +"Absent when outline: true was requested"
    • addedOutput schema / properties / notes / items / properties / error
      Added value: +{
      +  "description": "Only with outline: true, when this note's outline could not be computed: server busy, the call ran out of time, the note is too complex to parse, parsing failed, or the note has invalid UTF-8. Outline omitted",
      +  "type": "string"
      +}
    • addedOutput schema / properties / notes / items / properties / links_truncated
      Added value: +{
      +  "description": "true if backlinks, outgoing, or unresolved was cut off at the cap (include_links)",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / notes / items / properties / outgoing
      Added value: +{
      +  "description": "Paths of notes this one links to (include_links)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / notes / items / properties / outline
      Added value: +{
      +  "description": "Only with outline: true; replaces content. Absent when error is set",
      +  "items": {
      +    "properties": {
      +      "heading": {
      +        "type": "string"
      +      },
      +      "level": {
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "level",
      +      "heading"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / notes / items / properties / unresolved
      Added value: +{
      +  "description": "Link targets that match no note (include_links)",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
  3. Changed1 schema field changed
    • addedInput schema / additionalProperties
      Added value: +false
  4. Changed1 schema field changed
    • changedInput schema / properties / vault_id / description
      Previous value: -"Target vault — its name (e.g. \"Engram\") or its UUID. REQUIRED when you own more than one vault — the server keeps no active-vault state between calls, so it must be passed on every vault-scoped call. Omit only if you have a single vault. Call list_vaults if a name does not resolve."New value: +"Target vault: its name (e.g. \"Engram\") or its UUID. REQUIRED when you own more than one vault; the server keeps no active-vault state between calls, so it must be passed on every vault-scoped call. Omit only if you have a single vault. Call list_vaults if a name does not resolve."
  5. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.