memory_list
Browse and paginate stored memories with optional tag, type, agent, or inactivity filters to see what is saved.
Instructions
List and browse memories with pagination and optional filters.
USE THIS WHEN:
User wants to browse all memories ("show me my memories", "list everything")
Need to paginate through large result sets
Filter by tag OR memory type for categorical browsing
User asks "what do I have stored", "browse my memories"
Unlike memory_search (semantic search), this does categorical listing/filtering.
PAGINATION:
page: 1-based page number (default: 1)
page_size: Results per page (default: 20, max: 100)
FILTERS (combine with AND logic):
tags: Filter to memories with matching tags
tag_match: "any" (OR, default) or "all" (AND) — controls how multiple tags are matched
memory_type: Filter by type (note, reference, decision, etc.)
stale_days: Filter to memories not accessed in the last N days
Examples: {} // List first 20 memories {"page": 2, "page_size": 50} {"tags": ["python", "reference"]} {"tags": ["python", "reference"], "tag_match": "all"} {"memory_type": "decision", "page_size": 10} {"tags": ["important"], "memory_type": "note"} {"stale_days": 30} // Memories not accessed in 30 days {"stale_days": 7, "tags": ["archived"]} // Stale archived memories
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "memory_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (1-based) | |
| tags | No | Filter by tags (returns memories with ANY of these tags by default, use tag_match to control) | |
| store | No | Target store partition (default: 'default'). Use 'docs' for documents, 'all' for cross-store search. | |
| agent_id | No | Filter to memories authored by this agent (matches metadata.agent_id or the agent:<id> tag). Opt-in; omit to search all agents. | |
| page_size | No | Results per page | |
| tag_match | No | Match ANY tag (OR, default) or ALL tags (AND) | any |
| stale_days | No | Filter to memories not accessed in the last N days. Uses COALESCE(last_accessed, created_at) for memories never read. Currently supported on sqlite-vec backend only. | |
| memory_type | No | Filter by memory type |