Memory Box MCP Server

Memory Box is a semantic memory storage and retrieval system that enables intelligent organization and recall of information using vector embeddings. It allows users to save, search, and manage memories with contextual understanding rather than simple keyword matching. Key features: - Save memories with metadata, source information, and automatic vector embeddings - Semantic search capabilities to find memories based on meaning and context - Organize memories into customizable buckets for structured categorization - Retrieve related memories through semantic similarity matching - Update, delete, and monitor memory processing status - Format memories according to structured system prompts - Track usage statistics and resource limits Requires a Memory Box instance (self-hosted or using the hosted service at memorybox.amotivv.ai) with API token configuration.

Memory Box MCP Server

Cline and Claude Desktop MCP integration for Memory Box - save, search, and format memories with semantic understanding

This MCP server provides tools for interacting with a Memory Box instance, allowing you to save and search memories using semantic search directly from Cline and Claude Desktop.

Related Projects

This MCP server is designed to work with Memory Box, a semantic memory storage and retrieval system powered by vector embeddings.

Memory Box provides the backend API that this MCP server communicates with, allowing you to:

For more information about Memory Box, including how to set up your own instance, please visit the Memory Box website.

Features

Installation

The server has been installed and configured for use with Cline. Note that you need a running Memory Box instance (either self-hosted or using the hosted version at memorybox.amotivv.ai) to use this MCP server.

Installing as Claude Desktop Extension (Recommended)

The easiest way to use Memory Box with Claude Desktop is through the Desktop Extension:

1. Download the latest memory-box.mcpb file from the releases page 2. Open Claude Desktop 3. Go to Settings > Extensions 4. Click "Install from file" 5. Select the downloaded memory-box.mcpb file 6. Configure your Memory Box API token in the extension settings

The extension will automatically configure all necessary environment variables and tools.

Installing via Smithery

To install Memory Box MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @amotivv/memory-box-mcp --client claude

To complete the setup:

1. Edit the Cline MCP settings file at:

   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   

2. Add your Memory Box token to the MEMORY_BOX_TOKEN environment variable:

   "memory-box-mcp": {
     "command": "node",
     "args": [
       "/build/index.js"
     ],
     "env": {
       "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai",
       "MEMORY_BOX_TOKEN": "your-token-here",
       "DEFAULT_BUCKET": "General"
     },
     "disabled": false,
     "autoApprove": []
   }
   

3. Optionally, you can customize the default bucket by changing the DEFAULT_BUCKET value.

Usage

Once configured, you can use the following tools in Cline:

Save Memory

Save a memory to Memory Box with proper formatting:

Use the save_memory tool to save this information about vector databases: "Vector databases like pgvector store and query high-dimensional vectors for semantic search applications."

Parameters:

Search Memories

Search for memories using semantic search:

``` Use the search_memories tool to find information about "vector data