Memory Buckets

Organize your memories into separate contexts with MemoryPlugin’s bucket system

Written by asad

Last updated 2 months ago

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

Every account starts with a “General” bucket where all memories go by default. This bucket cannot be deleted, ensuring you always have a place for new memories.

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!

Naming requirements: Bucket names cannot be numbers alone (like “123”). You can include numbers in your bucket name, but it needs other characters too (like “Project 123” or “Q1 Goals”).

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

Context Separation

Keep work and personal memories completely separate

Project Organization

Organize memories by project, client, or topic

Focused Loading

Load only relevant memories for better AI performance

Team Collaboration

Share specific buckets with team members (coming soon)

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

Naming Convention

Use clear, descriptive names that will make sense to you months later. Consider using prefixes like “Project-”, “Client-”, or “Personal-” for consistency.

Bucket Strategy

Plan your bucket structure before creating many memories. Consider how you work and what contexts you need to keep separate.

Regular Review

Periodically review your buckets and memories to ensure they’re still organized in a way that serves your needs.

Team Coordination

If you’re planning to use team features, coordinate bucket naming and organization with your team members.

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

Smart Memory

Learn how Smart Memory optimizes bucket performance

Bulk Operations

Manage multiple memories and buckets efficiently