Menu
Pins or unpins a memory to protect it from pruning during dream consolidation. Use when a memory is critical and must never be removed, such as core preferences, important decisions, or immutable personal facts.
Searches and injects relevant memories into context before starting work on a task or topic. Use when beginning a new task, switching context, or when past decisions, preferences, or knowledge need to be loaded.
Consolidates stored memories by merging duplicates, resolving contradictions, and pruning stale entries. Use when memory count is high, search results feel noisy or repetitive, or periodic cleanup is needed to maintain memory quality.
Deletes memories by search query or memory ID with confirmation before removal. Use when removing outdated information, incorrect memories, sensitive data, or cleaning up after experiments.
Stores a memory verbatim from user input with appropriate category classification. Use when the user says remember this, save this, store this, note that, or explicitly asks to record a preference, decision, goal, or lesson.
Searches memories and displays compact one-liner results, or looks up a specific memory by ID. Use for quick memory lookups, checking if something was recorded, resolving [mem0:id] citations, or browsing memories without full category detail.
Diagnoses Mem0 connectivity, API key validity, and memory read/write functionality. Use when memory operations fail, searches return empty, or to verify the plugin is working correctly.
| name | pin |
| description | Pins or unpins a memory to protect it from pruning during dream consolidation. Use when a memory is critical and must never be removed, such as core preferences, important decisions, or immutable personal facts. |
Pin a memory to mark it as high-priority and protect from dream pruning.
The user provides either a search query or memory ID.
If memory ID: Look it up directly.
If search query:
mem0_memory tool with action="search", query=<query>.Pinning works by prepending [PINNED] to the memory text. This marker tells the dream consolidation to skip it during pruning.
Use mem0_memory tool with action="add", content="[PINNED] <original memory text>".
Then delete the original using mem0_memory with action="delete" and the original memory ID.
For new memories (user wants to pin text that isn't stored yet):
mem0_memory tool with action="add", content="[PINNED] <the user's text>".Pinned: "<memory content, first 80 chars>"
Append ... only if content exceeds 80 characters.
If the user says "unpin":
[PINNED] prefix.Unpinned: "<content>..."