memory_delete
Delete stored memories by tag, date range, or hash; preview bulk removals before executing to avoid accidental loss.
Instructions
Delete memories with flexible filtering. Combine filters for precise targeting.
USE THIS WHEN:
User says "delete", "remove", "forget" specific memories
Need to clean up by tag, time range, or specific hash
Bulk deletion with safety preview (dry_run=true)
FILTER COMBINATIONS (AND logic when multiple specified):
content_hash only: Delete single memory by hash
tags only: Delete memories with matching tags
before/after: Delete memories in time range
tags + time: Delete tagged memories within time range
SAFETY FEATURES:
dry_run=true: Preview what will be deleted without deleting
Returns deleted_hashes for audit trail
No filters = error (prevents accidental mass deletion)
Examples: {"content_hash": "abc123def456"} {"tags": ["temporary", "draft"], "tag_match": "any"} {"tags": ["archived", "old"], "tag_match": "all"} {"before": "2024-01-01"} {"after": "2024-06-01", "before": "2024-12-31"} {"tags": ["cleanup"], "before": "2024-01-01", "dry_run": true}
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_delete"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Filter by these tags | |
| after | No | Delete memories created after this date (ISO format: YYYY-MM-DD) | |
| store | No | Target store partition (default: 'default'). Use 'docs' for documents, 'all' for cross-store search. | |
| before | No | Delete memories created before this date (ISO format: YYYY-MM-DD) | |
| dry_run | No | Preview deletions without executing | |
| tag_match | No | Match ANY tag or ALL tags | any |
| content_hash | No | Specific memory hash to delete (ignores other filters if provided) |