memory_list
Retrieve stored memories from Memora using text search, date ranges, tags, and metadata filters to organize and access information efficiently.
Instructions
List memories, optionally filtering by substring query or metadata.
Args: query: Optional text search query metadata_filters: Optional metadata filters limit: Maximum number of results to return (default: unlimited) offset: Number of 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)
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 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- memora/server.py:698-733 (handler)The implementation of the MCP tool 'memory_list' which wraps the internal _list_memories function.
async def memory_list( query: Optional[str] = None, metadata_filters: Optional[Dict[str, Any]] = None, limit: Optional[int] = None, offset: Optional[int] = 0, date_from: Optional[str] = None, date_to: Optional[str] = None, tags_any: Optional[List[str]] = None, tags_all: Optional[List[str]] = None, tags_none: Optional[List[str]] = None, sort_by_importance: bool = False, ) -> Dict[str, Any]: """List memories, optionally filtering by substring query or metadata. Args: query: Optional text search query metadata_filters: Optional metadata filters limit: Maximum number of results to return (default: unlimited) offset: Number of 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) """ try: items = _list_memories( query, metadata_filters, limit, offset, date_from, date_to, tags_any, tags_all, tags_none, sort_by_importance, ) except ValueError as exc: return {"error": "invalid_filters", "message": str(exc)} return {"count": len(items), "memories": items}