Update Memory
vault_update_memoryAppend a dated entry to a memory file section to record preferences, principles, or facts. Entries are inserted newest-first by default and date is added automatically.
Instructions
Append a dated entry to a section of a About Me/ memory file. The server prefixes the date automatically (format: "- YYYY-MM-DD: entry text") and inserts newest-first by default. Pass raw entry text without a date prefix.
Example: vault_update_memory({ file: "Opinions", section: "Code patterns (newest first)", entry: "Prefer immutable data structures" })
When to use: Recording a new preference, principle, opinion, or fact about the user. Call vault_list_memory_files first and reuse existing file and section names so entries stay grouped. Prefer vault_write_note for creating non-memory notes.
Behavior: Additive — existing entries are never overwritten, and repeat calls add duplicate entries. A missing file or section is created automatically; if the section name omits "(newest first)" the server appends it ("Design preferences" becomes "Design preferences (newest first)") — use that full name in later calls.
Parameters:
options.date — ISO YYYY-MM-DD, defaults to today (server timezone).
options.position — "top" (default, newest-first) inserts above existing entries; "bottom" appends below them.
Obsidian syntax: Entry text renders as Obsidian Flavored Markdown. Watch for: #word = tag, [[ = wikilink. Escape with backslash or backticks when unintentional.
Returns: Confirmation message.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | Memory file name without .md (e.g. "Principles") | |
| section | Yes | H2 section heading (e.g. "Decision heuristics (newest first)") | |
| entry | Yes | Entry text (no date prefix) | |
| options | No | Optional date and position overrides |