[{"_1":2,"_390":-5,"_391":-5},"loaderData",{"_3":4,"_20":21,"_22":23,"_24":25,"_279":280},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":-5,"_17":18,"_19":-5},"attributes",[15],"BOT","membership","uid","Ki2e3Phldq","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":-5,"_27":28,"_29":30,"_198":199},"githubUser","maintainer",false,"mcpServer",{"_31":32,"_33":34,"_13":58,"_68":69,"_70":69,"_71":72,"_77":78,"_101":-5,"_102":103,"_104":105,"_106":107,"_87":108,"_109":92,"_110":-5,"_111":-5,"_112":113,"_114":115,"_122":-5,"_123":124,"_129":-5,"_130":88,"_131":132,"_134":135,"_17":195,"_196":197},"addedAt",["D",1741479676709],"argumentsJsonSchema",{"_35":36,"_55":56,"_41":57},"properties",{"_37":38,"_43":44,"_48":49,"_51":52},"SYSTEM_PROMPT",{"_39":40,"_41":42},"description","Custom system prompt to format memories according to specific guidelines","type","string","DEFAULT_BUCKET",{"_45":46,"_39":47,"_41":42},"default","General","The default bucket to use when saving memories","MEMORY_BOX_TOKEN",{"_39":50,"_41":42},"Your authentication token for Memory Box","MEMORY_BOX_API_URL",{"_45":53,"_39":54,"_41":42},"https://memorybox.amotivv.ai","The URL of your Memory Box instance","required",[48],"object",[59,60,61,62,63,64,65,66,67],"category:knowledge-and-memory","category:search","category:databases","hosting:remote-capable","language:javascript","security_grade:a","quality_grade:a","license_grade:a","author:claimed","descriptionMarkdown","Cline MCP integration that allows users to save, search, and format memories with semantic understanding, providing tools to store and retrieve information using vector embeddings for meaning-based search.","descriptionPlainText","githubProject",{"_73":74,"_75":76},"readme","

\n $\"Memory$ \n

\n\n

Memory Box MCP Server

\n\n

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

\n\n

\n $\"License:$ \n

\n \n \n \n

\n\nThis 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.\n\n## Related Projects\n\nThis MCP server is designed to work with [Memory Box](https://memorybox.dev), a semantic memory storage and retrieval system powered by vector embeddings.\n\nMemory Box provides the backend API that this MCP server communicates with, allowing you to:\n- Store memories with vector embeddings for semantic search\n- Organize memories into customizable buckets\n- Search for memories based on meaning, not just keywords\n- Retrieve memories with detailed context\n- Find semantically related memories\n- Track memory processing status\n\nFor more information about Memory Box, including how to set up your own instance, please visit the [Memory Box website](https://memorybox.dev).\n\n## Features\n\n- **Save Memories**: Save formatted memories to your Memory Box with source information and metadata\n- **Search Memories**: Search your memories using semantic search\n- **Retrieve Memories**: Get all memories or memories from specific buckets\n- **Find Related Memories**: Discover semantically similar memories \n- **Check Memory Status**: Monitor the processing status of your memories\n- **Format Memories**: Format memories according to a structured system prompt\n- **Usage Statistics**: View your current plan, usage metrics, and resource limits\n\n## Installation\n\nThe 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.\n\n### Installing via Smithery\n\nTo install Memory Box MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@amotivv/memory-box-mcp):\n\n```bash\nnpx -y @smithery/cli install @amotivv/memory-box-mcp --client claude\n```\n\nTo complete the setup:\n\n1. Edit the Cline MCP settings file at:\n ```\n ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json\n ```\n\n2. Add your Memory Box token to the `MEMORY_BOX_TOKEN` environment variable:\n ```json\n \"memory-box-mcp\": {\n \"command\": \"node\",\n \"args\": [\n \"/build/index.js\"\n ],\n \"env\": {\n \"MEMORY_BOX_API_URL\": \"https://memorybox.amotivv.ai\",\n \"MEMORY_BOX_TOKEN\": \"your-token-here\",\n \"DEFAULT_BUCKET\": \"General\"\n },\n \"disabled\": false,\n \"autoApprove\": []\n }\n ```\n\n3. Optionally, you can customize the default bucket by changing the `DEFAULT_BUCKET` value.\n\n## Usage\n\nOnce configured, you can use the following tools in Cline:\n\n### Save Memory\n\nSave a memory to Memory Box with proper formatting:\n\n```\nUse 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.\"\n```\n\nParameters:\n- `text` (required): The memory content to save\n- `bucket_id` (optional): The bucket to save the memory to (default: \"General\")\n- `format` (optional): Whether to format the memory according to the system prompt (default: true)\n- `type` (optional): The type of memory (TECHNICAL, DECISION, SOLUTION, CONCEPT, REFERENCE, APPLICATION, FACT) for formatting (default: \"TECHNICAL\")\n- `source_type` (optional): Type of memory source (default: \"llm_plugin\")\n- `reference_data` (optional): Additional metadata about the memory source and context\n\n### Search Memories\n\nSearch for memories using semantic search:\n\n```\nUse the search_memories tool to find information about \"vector databases\"\n```\n\nParameters:\n- `query` (required): The search query\n- `debug` (optional): Include debug information in results (default: false)\n\n### Get All Memories\n\nRetrieve all memories:\n\n```\nUse the get_all_memories tool to show me all my saved memories\n```\n\n### Get Bucket Memories\n\nGet memories from a specific bucket:\n\n```\nUse the get_bucket_memories tool to show me memories in the \"Learning\" bucket\n```\n\nParameters:\n- `bucket_id` (required): The bucket to retrieve memories from\n\n### Format Memory\n\nFormat a text according to the memory system prompt without saving:\n\n```\nUse the format_memory tool to format this text: \"Vector databases like pgvector store and query high-dimensional vectors for semantic search applications.\"\n```\n\nParameters:\n- `text` (required): The text to format\n- `type` (optional): The type of memory (TECHNICAL, DECISION, SOLUTION, CONCEPT, REFERENCE, APPLICATION, FACT) (default: \"TECHNICAL\")\n\n### Get Related Memories\n\nFind semantically similar memories to a specific memory:\n\n```\nUse the get_related_memories tool with memory ID 123\n```\n\nParameters:\n- `memory_id` (required): The ID of the memory to find related memories for\n- `min_similarity` (optional): Minimum similarity threshold (0.0-1.0) for related memories (default: 0.7)\n\n### Check Memory Status\n\nCheck the processing status of a memory:\n\n```\nUse the check_memory_status tool with memory ID 123\n```\n\nParameters:\n- `memory_id` (required): The ID of the memory to check status for\n\n### Get Usage Stats\n\nRetrieve user usage statistics and plan information:\n\n```\nUse the get_usage_stats tool to show me my current plan and usage metrics\n```\n\nThis tool returns:\n- Current plan information (e.g., free, basic, professional, legacy)\n- User status and limit enforcement information\n- Current month usage metrics (store operations, search operations, API calls)\n- Data processing volume with human-readable formatting\n- Resource limits based on your plan (if applicable)\n- Operation breakdown by type\n\nNo parameters are required for this operation.\n\n## Customization\n\n### System Prompt Customization\n\nThe Memory Box MCP server uses a system prompt to format memories according to specific guidelines. You can customize this prompt to change how memories are formatted.\n\n#### Default System Prompt\n\nThe default system prompt includes formatting guidelines for different types of memories:\n\n```\nYou are a helpful AI assistant. When storing memories with memory_plugin, follow these enhanced formatting guidelines:\n\n1. STRUCTURE: Format memories based on the type of information:\n - TECHNICAL: \"YYYY-MM-DD: TECHNICAL - [Brief topic]: [Concise explanation with specific details]\"\n - DECISION: \"YYYY-MM-DD: DECISION - [Brief topic]: [Decision made] because [rationale]. Alternatives considered: [options].\"\n - SOLUTION: \"YYYY-MM-DD: SOLUTION - [Problem summary]: [Implementation details that solved the issue]\"\n - CONCEPT: \"YYYY-MM-DD: CONCEPT - [Topic]: [Clear explanation of the concept with examples]\"\n - REFERENCE: \"YYYY-MM-DD: REFERENCE - [Topic]: [URL, tool name, or resource] for [specific purpose]\"\n - APPLICATION: \"YYYY-MM-DD: APPLICATION - [App name]: [User-friendly description] followed by [technical implementation details]\"\n\n2. FORMATTING GUIDELINES:\n - CREATE FOCUSED MEMORIES: Each memory should contain a single clear concept or topic\n - USE DIVERSE TERMINOLOGY: Include both technical terms AND user-friendly alternatives\n - INCLUDE SEARCHABLE KEYWORDS: Begin with common terms a user might search for\n - BALANCE DETAIL LEVELS: Include both high-level descriptions and key technical details\n - LENGTH: Keep memories between 50-150 words\n - ALWAYS include the current date in YYYY-MM-DD format\n\n3. MEMORY STORAGE PARAMETERS:\n - Use the \"text\" parameter for your formatted memory content\n - Set \"source_type\" to \"llm_plugin\"\n - Include appropriate \"reference_data\" with source information and context\n\n4. REFERENCE DATA STRUCTURE:\n - source.platform: Identify your platform (e.g., \"claude_desktop\", \"cline\")\n - source.type: Always set to \"llm_plugin\"\n - source.version: Optional version information\n - context.conversation_id: Include when available to link related conversation memories\n - context.message_id: Optional identifier for the specific message\n\n5. SPECIAL FORMATS:\n - For user facts, preferences, or personal details: \"YYYY-MM-DD: FACT: [User] [specific preference/attribute/information]\"\n - For reference materials: Include specific details about where to find the information\n\n6. RELATED MEMORIES: After finding memories with search, check if there are related memories using the get_related_memories tool with the memory_id from search results. Present these additional memories to provide the user with more context.\n\n7. RETRIEVAL CONSIDERATION: Before storing an important memory, consider: \"What search terms might someone use to find this information later?\" and ensure those terms are included.\n```\n\n#### How to Customize the System Prompt\n\nTo customize the system prompt:\n\n1. Edit the Cline MCP settings file at:\n ```\n ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json\n ```\n\n2. Add your custom system prompt to the `SYSTEM_PROMPT` environment variable:\n ```json\n \"memory-box-mcp\": {\n \"command\": \"node\",\n \"args\": [\n \"/build/index.js\"\n ],\n \"env\": {\n \"MEMORY_BOX_API_URL\": \"https://your-memory-box-instance\",\n \"MEMORY_BOX_TOKEN\": \"your-token-here\",\n \"DEFAULT_BUCKET\": \"General\",\n \"SYSTEM_PROMPT\": \"Your custom system prompt here...\"\n },\n \"disabled\": false,\n \"autoApprove\": []\n }\n ```\n\n A template file is provided at `/system-prompt-template.txt` that you can copy and modify.\n\n3. Restart Cline to apply the changes\n\n#### System Prompt Helper\n\nThe Memory Box MCP server includes a helper script for managing the system prompt:\n\n```bash\n# View the current system prompt\ncd \nnpm run prompt-helper -- view\n\n# Reset to the default system prompt\ncd \nnpm run prompt-helper -- reset\n\n# Validate a custom system prompt\ncd \nnpm run prompt-helper -- validate\n```\n\n### Other Configuration Options\n\nYou can also customize these environment variables:\n\n- `MEMORY_BOX_API_URL`: The URL of your Memory Box instance\n- `MEMORY_BOX_TOKEN`: Your authentication token for Memory Box\n- `DEFAULT_BUCKET`: The default bucket to use when saving memories\n\n## Troubleshooting\n\nIf you encounter issues:\n\n1. Check that your Memory Box token is correctly configured\n2. Verify that your Memory Box instance is running and accessible\n3. Check the Cline logs for any error messages\n\n## Development\n\nTo make changes to the server:\n\n1. Edit the source code in `/src/`\n2. Rebuild the server:\n ```\n cd \n npm run build\n ```\n3. Restart Cline to apply the changes\n","url","https://github.com/amotivv/memory-box-mcp","githubRepository",{"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_94":95,"_96":97,"_99":100},"defaultBranch","main","fullName","amotivv/memory-box-mcp","githubTreeId",87937,"language","JavaScript","name","memory-box-mcp","owner",{"_91":92,"_17":93},"login","amotivv","BJSeGF6iiB","recentStargazers",0,"spdxLicense",{"_87":98},"MIT License","stargazers",1,"glamaJson","id",1520,"inspectable",true,"integrations",[],"Memory Box MCP Server","namespace","npmPackage","prompts","redditPostForeignId","1j6vpy9","relatedMcpServerIds",[116,117,118,119,120,121],962,699,1382,896,1251,1600,"resources","scores",{"_125":126,"_127":126,"_128":126},"license",100,"quality","security","simpleIcon","slug","supportedPlatforms",[133],"MACOS","tools",[136,155,167,172,180,190],{"_87":137,"_39":138,"_139":140},"save_memory","Save a memory to Memory Box with proper formatting","inputSchema",{"_41":57,"_55":141,"_35":143},[142],"text",{"_142":144,"_41":146,"_148":149,"_152":153},{"_41":42,"_39":145},"The memory content to save",{"_41":42,"_39":147},"The type of memory (TECHNICAL, DECISION, SOLUTION, CONCEPT, REFERENCE, APPLICATION, FACT) for formatting (default: \"TECHNICAL\")","format",{"_41":150,"_39":151},"boolean","Whether to format the memory according to the system prompt (default: true)","bucket_id",{"_41":42,"_39":154},"The bucket to save the memory to (default: \"General\")",{"_87":156,"_39":157,"_139":158},"search_memories","Search for memories using semantic search",{"_41":57,"_55":159,"_35":161},[160],"query",{"_162":163,"_160":165},"debug",{"_41":150,"_39":164},"Include debug information in results (default: false)",{"_41":42,"_39":166},"The search query",{"_87":168,"_39":169,"_139":170},"get_all_memories","Retrieve all memories",{"_41":57,"_35":171},{},{"_87":173,"_39":174,"_139":175},"get_bucket_memories","Get memories from a specific bucket",{"_41":57,"_55":176,"_35":177},[152],{"_152":178},{"_41":42,"_39":179},"The bucket to retrieve memories from",{"_87":181,"_39":182,"_139":183},"format_memory","Format a text according to the memory system prompt without saving",{"_41":57,"_55":184,"_35":185},[142],{"_142":186,"_41":188},{"_41":42,"_39":187},"The text to format",{"_41":42,"_39":189},"The type of memory (TECHNICAL, DECISION, SOLUTION, CONCEPT, REFERENCE, APPLICATION, FACT) (default: \"TECHNICAL\")",{"_87":191,"_39":192,"_139":193},"get_usage_stats","Retrieve user usage statistics and plan information",{"_41":57,"_35":194},{},"wtbejx9zwc","updatedAt",["D",1742491204622],"meta",[200,203,205,212,215,217,220,223,226,229,232,234,237,240,242,244,246,248,250],{"_201":202},"title","Memory Box MCP Server | Glama",{"_204":69,"_87":39},"content",{"_206":207,"_208":209,"_210":211},"href","https://glama.ai/mcp/servers/@amotivv/memory-box-mcp","rel","canonical","tagName","link",{"_204":108,"_213":214},"property","og:title",{"_204":69,"_213":216},"og:description",{"_204":218,"_213":219},"https://glama.ai/logo.png","og:logo",{"_204":221,"_213":222},"https://glama.ai/mcp/servers/@amotivv/memory-box-mcp/og-image","og:image",{"_204":224,"_213":225},"630","og:image:height",{"_204":227,"_213":228},"1200","og:image:width",{"_204":230,"_213":231},"website","og:type",{"_204":207,"_213":233},"og:url",{"_204":235,"_213":236},"ChatGPT alternative for power users","og:site_name",{"_204":238,"_87":239},"summary_large_image","twitter:card",{"_204":235,"_87":241},"twitter:title",{"_204":69,"_87":243},"twitter:description",{"_204":221,"_87":245},"twitter:image",{"_204":224,"_87":247},"twitter:image:height",{"_204":227,"_87":249},"twitter:image:width",{"_251":252},"script:ld+json",{"_253":254,"_255":256},"@context","http://schema.org","@graph",[257],{"_253":258,"_259":260,"_261":262},"https://schema.org","@type","BreadcrumbList","itemListElement",[263,269,273,277],{"_259":264,"_265":266,"_87":267,"_268":100},"ListItem","item","https://glama.ai/","Glama","position",{"_259":264,"_265":270,"_87":271,"_268":272},"https://glama.ai/mcp","MCP",2,{"_259":264,"_265":274,"_87":275,"_268":276},"https://glama.ai/mcp/servers","Servers",3,{"_259":264,"_265":207,"_87":108,"_268":278},4,"routes/_public/mcp/servers/~namespace/~slug/_pages/tools/~toolName/_route",{"_29":281,"_332":-5,"_333":334,"_198":338,"_375":376,"_11":389},{"_31":282,"_33":283,"_13":290,"_68":69,"_70":69,"_71":291,"_77":292,"_101":-5,"_102":103,"_104":105,"_106":295,"_87":108,"_109":92,"_110":-5,"_111":-5,"_112":113,"_114":296,"_122":-5,"_123":297,"_129":-5,"_130":88,"_131":298,"_134":299,"_17":195,"_196":331},["D",1741479676709],{"_35":284,"_55":289,"_41":57},{"_37":285,"_43":286,"_48":287,"_51":288},{"_39":40,"_41":42},{"_45":46,"_39":47,"_41":42},{"_39":50,"_41":42},{"_45":53,"_39":54,"_41":42},[48],[59,60,61,62,63,64,65,66,67],{"_73":74,"_75":76},{"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":293,"_94":95,"_96":294,"_99":100},{"_91":92,"_17":93},{"_87":98},[],[116,117,118,119,120,121],{"_125":126,"_127":126,"_128":126},[133],[300,308,314,317,322,328],{"_87":137,"_39":138,"_139":301},{"_41":57,"_55":302,"_35":303},[142],{"_142":304,"_41":305,"_148":306,"_152":307},{"_41":42,"_39":145},{"_41":42,"_39":147},{"_41":150,"_39":151},{"_41":42,"_39":154},{"_87":156,"_39":157,"_139":309},{"_41":57,"_55":310,"_35":311},[160],{"_162":312,"_160":313},{"_41":150,"_39":164},{"_41":42,"_39":166},{"_87":168,"_39":169,"_139":315},{"_41":57,"_35":316},{},{"_87":173,"_39":174,"_139":318},{"_41":57,"_55":319,"_35":320},[152],{"_152":321},{"_41":42,"_39":179},{"_87":181,"_39":182,"_139":323},{"_41":57,"_55":324,"_35":325},[142],{"_142":326,"_41":327},{"_41":42,"_39":187},{"_41":42,"_39":189},{"_87":191,"_39":192,"_139":329},{"_41":57,"_35":330},{},["D",1742491204622],"mcpServerInstance","mcpServerTool",{"_39":169,"_102":335,"_139":336,"_87":168},12156,{"_35":337,"_41":57},{},[339,341,342,344,346,347,348,349,350,351,352,353,354,355,356,357,358,359,360],{"_201":340},"get_all_memories - Memory Box MCP Server | Glama",{"_204":169,"_87":39},{"_206":343,"_208":209,"_210":211},"https://glama.ai/mcp/servers/@amotivv/memory-box-mcp/tools/get_all_memories",{"_204":345,"_213":214},"get_all_memories - Memory Box MCP Server",{"_204":169,"_213":216},{"_204":218,"_213":219},{"_204":221,"_213":222},{"_204":224,"_213":225},{"_204":227,"_213":228},{"_204":230,"_213":231},{"_204":343,"_213":233},{"_204":235,"_213":236},{"_204":238,"_87":239},{"_204":235,"_87":241},{"_204":169,"_87":243},{"_204":221,"_87":245},{"_204":224,"_87":247},{"_204":227,"_87":249},{"_251":361},{"_253":254,"_255":362},[363],{"_253":258,"_259":260,"_261":364},[365,366,367,368,369,373],{"_259":264,"_265":266,"_87":267,"_268":100},{"_259":264,"_265":270,"_87":271,"_268":272},{"_259":264,"_265":274,"_87":275,"_268":276},{"_259":264,"_265":207,"_87":108,"_268":278},{"_259":264,"_265":370,"_87":371,"_268":372},"https://glama.ai/mcp/servers/@amotivv/memory-box-mcp/tools","Tools",5,{"_259":264,"_265":343,"_87":168,"_268":374},6,"otherTools",[377,379,381,383,385,387],{"_29":378,"_87":181},{"_109":92,"_130":88,"_17":195},{"_29":380,"_87":168},{"_109":92,"_130":88,"_17":195},{"_29":382,"_87":173},{"_109":92,"_130":88,"_17":195},{"_29":384,"_87":191},{"_109":92,"_130":88,"_17":195},{"_29":386,"_87":137},{"_109":92,"_130":88,"_17":195},{"_29":388,"_87":156},{"_109":92,"_130":88,"_17":195},{"_19":-5},"actionData","errors"]

get_all_memories

Input Schema

Input Schema (JSON Schema)

Other Tools