List memories (no query)
memory_listRead-onlyIdempotent
List stored memories with optional filters by type, scope, project, or vault folder. Ordered by recency or importance. Use to browse or enumerate memories before searching. Supports detail levels to control token cost.
Instructions
Browse stored memories with optional filters — ordered by recency/importance. Read-only. Use to enumerate by type/scope/project. Prefer memory_search whenever you have keywords (relevance ranking). Use the same detail levels to control token cost.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_path | No | Optional absolute project path filter. Empty string lists across all projects. | |
| memory_type | No | Optional type filter (e.g. `decision`). Empty string returns all types. | |
| scope | No | Optional scope filter — `project`, `global`, or `team`. Empty string returns all scopes. | |
| pinned_only | No | If true, only return pinned memories. | |
| limit | No | Maximum number of memories to return (1-200). Default 20. | |
| detail | No | Disclosure level — `index` (cheapest), `summary`, or `full` (default). Drop to `index` when listing many rows to keep token cost down. | full |
| include_file_memories | No | If true, also include markdown file-memory sources. Off by default since lists are usually about SQLite-backed memories. | |
| vault_kind | No | Optional vault subtype filter when listing vault notes. | |
| vault_folder | No | Optional vault subfolder filter (relative to vault root). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| detail | Yes | Disclosure level used to render this list. | |
| count | Yes | Number of SQLite/file memories returned. | |
| memories | Yes | Listed memories ordered by recency/importance. | |
| vault_results | Yes | Obsidian vault matches when the vault is enabled and `vault_kind`/`vault_folder` filters apply. Empty otherwise. |