memory_list
List memories using filters for text, metadata, tags, and dates. Sort by importance or choose between preview and full content.
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 — "latest" resolves each result to its current version, "active" excludes superseded memories, "full_history" expands supersession chains.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | ||
| metadata_filters | No | ||
| limit | No | ||
| offset | No | ||
| date_from | No | ||
| date_to | No | ||
| tags_any | No | ||
| tags_all | No | ||
| tags_none | No | ||
| sort_by_importance | No | ||
| content_mode | No | preview | |
| preview_chars | No | ||
| fields | No | ||
| follow | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |