memory_list
Retrieve memories matching your criteria. Filter by text, tags, dates, metadata, or importance to quickly find needed context.
Instructions
List memories, optionally filtering by substring query or metadata.
Returns compact previews by default to reduce context usage.
Use content_mode="full" when you need the complete content.
Use memory_get to fetch full content for specific IDs.
Args:
query: Optional text search query
metadata_filters: Optional metadata filters
limit: Maximum results (default: 20). Pass -1 for unlimited.
offset: Number of filtered results to skip (default: 0)
date_from: Optional date filter (ISO format or relative like "7d", "1m", "1y")
date_to: Optional date filter (ISO format or relative like "7d", "1m", "1y")
tags_any: Match memories with ANY of these tags (OR logic)
tags_all: Match memories with ALL of these tags (AND logic)
tags_none: Exclude memories with ANY of these tags (NOT logic)
sort_by_importance: Sort results by importance score (default: False, sorts by date)
content_mode: "preview" (default) returns truncated content_preview; "full" returns complete content
preview_chars: Max chars for preview (default: 120, ignored when content_mode="full")
fields: Optional list of fields to return (e.g. ["id","content_preview","tags"]). None returns all fields.
follow: Lineage mode. Default active (excludes superseded memories).
latest resolves each hit to its current version;
full_history expands supersession chains;
all is the explicit unfiltered forensic escape hatch (includes superseded).
Omitting follow is NOT unfiltered — it means the safe default.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | ||
| fields | No | ||
| follow | No | ||
| offset | No | ||
| date_to | No | ||
| tags_all | No | ||
| tags_any | No | ||
| date_from | No | ||
| tags_none | No | ||
| content_mode | No | preview | |
| preview_chars | No | ||
| metadata_filters | No | ||
| sort_by_importance | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |