MCP Structured Memory

🚀 Structured Memory MCP Server

A Model Context Protocol (MCP) server that offers structured, domain - specific memory management via markdown files. Ideal for long - term projects in specific areas, enabling the accumulation of valuable context over time, such as travel planning, research projects, real - estate searches, investment theses, product planning, and career development.

🚀 Quick Start

To get started with the Structured Memory MCP Server, follow these steps:

1. Ask your LLM client to create a memory document for your focused project. For example: Create a new travel advisor memory document and tell me how to use it. This should start empty and grow over time.
2. Create a new Project for conversations in that area. Add the provided usage instructions to your project context. Note: LLMs will, against all tool advice, occasionally fail to show you the installation instructions. If that happens, follow up with a request to the LLM to show you the installation instructions and it should comply.
3. New chat conversations start by checking the available info from the project's memory. Your LLM will update this memory over time to build up valuable context.
4. Optionally prompt your LLM to add/adjust the memory file on demand. It's also helpful to ask the LLM to prompt you for relevant info (e.g., "Ask me some questions to learn about my travel preferences")

✨ Features

Why Structured Memory?

Traditional MCP memory servers rely on semantic search across scattered conversation snippets. While effective for general recall, they fall short for focused projects that require organized, categorical information.

Structured Memory, on the other hand, maintains living documents with structured content that you can scan, update, and track over time. It's like having a personal notebook but with AI assistance.

Memory documents are stored as markdown files, and are primarily updated automatically by the LLM as it learns from your conversations to build rich context over time.

Flexible Structure

Memory documents support any structure you need. The AI will help you organize sections based on your use case. Common examples include:

• Travel Planning: destinations, itinerary, accommodations, activities, restaurants, travel tips, budget tracker
• Research Project: research questions, literature review, methodology, findings, data sources, next steps
• Real Estate Search: search criteria, active listings, visited properties, rejected properties, market insights, agent contacts

Backup and Version Control

The server automatically creates timestamped backups before major updates.

📦 Installation

Option 1: Install from npm (when published)

npm install -g @nmeierpolys/mcp-structured-memory

Option 2: Install from source

git clone https://github.com/nmeierpolys/mcp-structured-memory.git
cd mcp-structured-memory
npm install
npm run build

📚 Documentation

Configuration

For Claude Desktop

Edit the claude_desktop_config.json file with the following entry:

{
  "mcpServers": {
    "mcp-structured-memory": {
      "command": "npx",
      "args": ["@nmeierpolys/mcp-structured-memory"]
    }
  }
}

Available Tools

• create_memory - Create a new memory document with optional initial content
• list_memories - List all available memory documents
• get_memory_summary - Get a high - level summary of a memory document
• get_section - Retrieve a specific section from a memory document
• get_full_memory - Retrieve the complete content of a memory document
• search_within_memory - Search for information within a memory document
• update_section - Update an entire section of a memory document
• add_to_list - Add an item to a list section
• update_list_item - Update an existing item in a list
• move_list_item - Move an item between list sections

Example: Automatic Memory Building

User: "Create a new Minnesota trip memory document and tell me how to use it. This should start empty and grow over time."

Claude: "I've created a travel memory document for your Minnesota trip. As we discuss your plans, I'll automatically update it with destinations, timing, preferences, and other details I learn about your trip."

User: "I want to see fall colors, go hiking, try local cuisine, and visit both the North Shore and the Twin Cities."

Claude: "I've noted your priorities in the memory: fall foliage viewing, hiking opportunities, local restaurants, North Shore destinations, and Twin Cities attractions. I'll keep track of specific recommendations as we explore options."

[Later conversation]
User: "What hiking trails have good fall colors?"

Claude: "Based on our previous discussions, I see you're focused on fall colors in Minnesota. Let me suggest some trails and I'll add the best ones to your travel memory..."

Storage Locations

Memory document files are stored as markdown files in:

• macOS: ~/Library/Application Support/mcp-structured-memory/
• Windows: %LOCALAPPDATA%\mcp-structured-memory\
• Linux: ~/.local/share/mcp-structured-memory/