Memory Buckets

Memory Buckets are an organizational system that lets you group related memories together into separate, isolated collections. Think of them as folders for your memories.

​

What are Memory Buckets?

Buckets let you organize your memories into completely separate contexts. Each bucket is isolated from others, so your work memories stay separate from personal ones, and project-specific information doesn’t mix with general notes. Perfect for organizing by:

• Context: Personal vs. Work vs. Hobbies
• Projects: Different client work or personal projects
• Topics: Learning materials, research, creative ideas
• Time periods: Quarterly goals, event planning

​

Creating a New Bucket

Creating buckets is straightforward:

1. Open your MemoryPlugin Dashboard
2. Click the “New Bucket” button
3. Give your bucket a descriptive name
4. Click “Create” and you’re done!

​

Using Buckets

​

With Browser Extension

When using the browser extension, you can switch between buckets using the MemoryPlugin interface. Click the MemoryPlugin button to see your buckets and select which one to use for the current conversation.

​

With MCP Server

Specify which bucket to load memories from in your MCP client configuration or during conversations by asking the AI to load memories from a specific bucket.

​

With Custom GPT

You can ask the MemoryPlugin Custom GPT to work with specific buckets:

• “Load memories from my Work bucket”
• “Store this in my Personal bucket”
• “Use Project A bucket for this chat” (to load and add memories to that bucket by default)

​

Benefits of Using Buckets

​

Are there any limits on buckets?

​

Bucket Creation

There are no limits on the number of buckets you can create. You can create as many buckets as you need to organize your memories effectively.

​

Feature Limitations

Some advanced features have requirements or limits based on your bucket’s size: Minimum Requirements:

• Smart Memory Categories: Requires at least 30 memories in a bucket to generate meaningful category groupings

Maximum Limits:

• Smart Memory Categories: Won’t process buckets larger than 600,000 tokens or 2,000 memories (for performance)
• Memory Suggestions: Automatically skips individual memories with >10,000 tokens during analysis

Context Window Limits: The dashboard shows how your bucket size compares to different AI model limits:

• ChatGPT Plus: 32,000 tokens
• ChatGPT Pro: 128,000 tokens
• Claude: 200,000 tokens
• Gemini: 1,000,000 tokens

These limitations help ensure optimal performance and meaningful results from AI-powered features.

​

Managing Buckets

​

Viewing Buckets

All your buckets are visible in the MemoryPlugin Dashboard where you can:

• See bucket names and memory counts
• Access memories within each bucket
• Switch between buckets easily

​

Moving Memories

You can move memories between buckets using:

• The dashboard interface
• Bulk operations for multiple memories
• API calls for programmatic management

​

Deleting Buckets

You can delete buckets you no longer need, with these restrictions:

• The “General” bucket cannot be deleted
• Deleting a bucket will also delete all memories within it
• This action cannot be undone, so be careful!

​

Best Practices

​

Example Bucket Structures

​

Freelancer/Consultant

• General (default)
• Client-Acme Corp
• Client-Beta LLC
• Personal Projects
• Learning & Development

​

Software Developer

• General (default)
• Project-WebApp
• Project-MobileApp
• Technical Research
• Work Notes
• Personal Coding

​

Content Creator

• General (default)
• YouTube Channel
• Blog Content
• Client Work
• Research & Ideas
• Personal Brand

​

Integration with Other Features

​

Smart Memory

Smart Memory works at the bucket level, creating high-level overviews of memories within each bucket for more efficient AI interactions.

​

Bulk Operations

Use bulk operations to move multiple memories between buckets or perform actions on entire bucket contents.

​

Next Steps