save_memory
Save memory entries with automatic deduplication and chunking of long content for verbatim recall. Memories expire after 7 days.
Instructions
Save a memory entry (Lite: 7-day TTL). Auto-deduplicates exact and near-duplicate content. Long content (>chunk_threshold chars) is chunked with a parent-document for verbatim recall.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | Memory content to save. | |
| agent_name | No | Agent display name (e.g. 'claude-code'). | |
| owner_id | No | Owner UUID override (must match server config). | |
| importance | No | Importance weight 0.5–2.0 (default 1.0). | |
| session_id | No | Optional project/task grouping key. Stored on the row and used as: (a) the ranking key for search_memory's b_session boost (match=1.0 / mismatch=0.6), and (b) the filter for delete_memories_by_session. Pass the same value across all calls for one project. Leave blank to use the server default (N3MC_SESSION_ID env var, or per-process UUIDv4). | |
| turn_id | No | §4.3.1 — Optional turn grouping label. Tag all memories saved within one conversation turn with the same turn_id. Enables recall_thread to surface the surrounding context later. Any non-empty string works; a short UUID, timestamp, or 'turn-N' format is recommended. |