Memory Box

by amotivv

4 stars

Not rated

GitHub

About

Integrates with Memory Box to provide persistent, context-aware interactions through semantic memory storage and retrieval using vector embeddings and search capabilities.

Details

Author: amotivv
Repository: amotivv/memory-box-mcp
GitHub stars: 4
License: MIT License
Categories: Developer Tools, Design, File Management, AI, Search, Frontend, Knowledge Base, Infrastructure
Tags: #integration

- Save Memories: Save formatted memories to your Memory Box with source information and metadata
- Search Memories: Search your memories using semantic search with pagination and date sorting
- Retrieve Memories: Get all memories or memories from specific buckets
- Bucket Management: Create and delete buckets for organizing memories
- Memory Management: Update or delete existing memories
- Find Related Memories: Discover semantically similar memories
- Check Memory Status: Monitor the processing status of your memories
- Format Memories: Format memories according to a structured system prompt
- Usage Statistics: View your current plan, usage metrics, and resource limits

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Memory Box

Command (node, npx, python, etc.) node
Arguments
- Argument 1 <path-to-repository>/build/index.js
Environment
- DEFAULT_BUCKET General
- MEMORY_BOX_TOKEN your-token-here
- MEMORY_BOX_API_URL https://memorybox.amotivv.ai
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "/c",
                "node",
                "<path-to-repository>/build/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "/c",
                "node",
                "<path-to-repository>/build/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "/c",
                "node",
                "<path-to-repository>/build/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "/c",
                "node",
                "<path-to-repository>/build/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "/c",
                "node",
                "<path-to-repository>/build/index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

From the repository

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

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.

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": [

       "<path-to-repository>/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.

`save_memory`

Save formatted memories to your Memory Box with source information and metadata. Parameters: text (required), bucket_id (optional), format (optional), type (optional), source_type (optional), reference_data (optional)

`search_memories`

Search for memories using semantic search. Parameters: query (required), debug (optional)

`get_all_memories`

Retrieve all memories.

`get_bucket_memories`

Get memories from a specific bucket. Parameters: bucket_id (required)

`format_memory`

Format a text according to the memory system prompt without saving. Parameters: text (required), type (optional)

`get_related_memories`

Find semantically similar memories to a specific memory. Parameters: memory_id (required), min_similarity (optional)

`check_memory_status`

Check the processing status of a memory. Parameters: memory_id (required)

`get_usage_stats`

Retrieve user usage statistics and plan information.

`get_buckets`

List all available buckets.

`create_bucket`

Create a new bucket for organizing memories. Parameters: bucket_name (required)

`delete_bucket`

Delete an existing bucket. Parameters: bucket_name (required), force (optional)

`update_memory`

Update an existing memory's content, bucket, or metadata. Parameters: memory_id (required), text (optional), bucket_id (optional), reference_data (optional)

`delete_memory`

Delete a specific memory. Parameters: memory_id (required)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "memory box": {
            "env": {
                "DEFAULT_BUCKET": "General",
                "MEMORY_BOX_TOKEN": "your-token-here",
                "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
            },
            "args": [
                "<path-to-repository>/build/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "DEFAULT_BUCKET": "General",
        "MEMORY_BOX_TOKEN": "your-token-here",
        "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
    },
    "args": [
        "<path-to-repository>/build/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "DEFAULT_BUCKET": "General",
        "MEMORY_BOX_TOKEN": "your-token-here",
        "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
    },
    "args": [
        "<path-to-repository>/build/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "DEFAULT_BUCKET": "General",
        "MEMORY_BOX_TOKEN": "your-token-here",
        "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai"
    },
    "args": [
        "/c",
        "node",
        "<path-to-repository>/build/index.js"
    ],
    "command": "cmd"
}

<h1 align="center">Memory Box MCP Server</h1>

<p align="center">
Cline and Claude Desktop MCP integration for Memory Box - save, search, and format memories with semantic understanding
</p>

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:
- Store memories with vector embeddings for semantic search
- Organize memories into customizable buckets
- Search for memories based on meaning, not just keywords
- Retrieve memories with detailed context
- Find semantically related memories
- Track memory processing status

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:

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": [

       "<path-to-repository>/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."

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

save_memory

search_memories

get_all_memories

get_bucket_memories

format_memory

get_related_memories

check_memory_status

get_usage_stats

get_buckets

create_bucket

delete_bucket

update_memory

delete_memory

Claude Desktop / Cursor

Linux

Macos

Windows

Related Projects

Features

Installation

Installing as Claude Desktop Extension (Recommended)

Installing via Smithery

Usage

Save Memory

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright

`save_memory`

`search_memories`

`get_all_memories`

`get_bucket_memories`

`format_memory`

`get_related_memories`

`check_memory_status`

`get_usage_stats`

`get_buckets`

`create_bucket`

`delete_bucket`

`update_memory`

`delete_memory`