Why it exists
Without categories, MemoryPlugin loads a bucket as one flat list. That works, but it has costs as the bucket grows:Irrelevant context
Dumping every memory feeds the model a lot it doesn’t need, which can make its answers worse.
Context window pressure
Memories take up space that your actual conversation could use.
Token cost
API tools bill per token, so loading everything every time costs more and hits rate limits sooner.
How it works
Smart Memory works one bucket at a time:- Analysis: the AI reads the memories in a bucket to find themes.
- Categorization: it groups related memories into categories such as “Work Projects” or “Health & Fitness”.
- Summarization: it writes a short summary and additional context for each category.
- Selective loading: at recall time, your AI loads the category summaries first, then pulls the full memories only from the categories it needs.
Requirements and limits
- Memory buckets only. File buckets and buckets shared to you cannot be categorized.
- At least 30 memories in the bucket before it can build categories.
- Won’t process a bucket over 600,000 tokens or 2,000 memories.
Building categories
1
Add memories
Get the bucket to at least 30 memories. The Smart Categories panel shows how many you have and how many you still need.
2
(Optional) define your own categories
Click the gear icon to open Custom Categories (Optional) and enter 2 to 10 category names. Leave it empty to let the AI decide. This option is only available before the first run.
3
Organize
Click Organize with AI. You will see a queued toast and a progress percentage. It usually takes a few minutes.
4
Review
Categories appear with per-category memory counts, a summary, and additional context. Re-run Organize with AI any time to recategorize.

What each category gives you
- Name: the theme the AI identified.
- Summary: a high-level overview of the memories in the category.
- Additional Info: deeper context about what the category covers. This is what helps your AI decide when to load the category, so it tends to matter more than the summary for recall quality.
- Memory count: how many memories are grouped there.
Resetting categories
To clear categories and start over, click Remove All Categories. The Reset categories for dialog asks you to typereset my categories to confirm, because it cannot be undone. Resetting removes every category, detaches category assignments from every memory in the bucket, and clears Smart Memory progress so you can recategorize from scratch.
Where categories are available
Once a bucket has Smart Categories:- Browser extension: turn on Smart Mode and your AI can load specific categories in chat on ChatGPT, Claude, and other supported platforms.
- MCP server: MCP clients can call
list_bucket_categoriesandlist_category_memoriesto browse categories and pull memories from one. - TypingMind plugin: exposes the same
list_bucket_categoriesandlist_category_memoriesfunctions. - Custom GPT: does not expose the category tools today. It works with buckets and memories, but not category-level loading.
When it helps most
Smart Memory earns its keep on large buckets. If you have hundreds or thousands of memories, or several dense projects in one bucket, categories keep recall focused and cut token cost. A small bucket of a few dozen memories is usually fine to load whole, which is why the 30-memory minimum exists.Next steps
Memory Buckets
Organize memories into buckets before categorizing them
Dashboard
Find the Smart Categories panel and manage your buckets
