Structured Memory

What is Structured Memory?

Structured Memory is a Model Context Protocol (MCP) server that provides structured, domain-specific memory management through markdown files. It is designed for ongoing projects where you want to accumulate valuable context over time, such as travel planning, research projects, real estate search, investment theses, product planning, and career development.

How to use Structured Memory?

Install via npm (npm install -g @nmeierpolys/mcp-structured-memory) or from source. Configure the server in your MCP client (e.g., Claude Desktop) by adding an entry to claude_desktop_config.json. Use tools like create_memory and list_memories to manage memory documents; the LLM will automatically update these documents as you converse.

Key features of Structured Memory

• Maintains living documents with structured, categorical information.
• Stores memory as markdown files in platform-specific directories.
• Automatically creates timestamped backups before major updates.
• Provides ten tools for reading, writing, and searching memory.
• Allows flexible, domain-specific section structures.

Use cases of Structured Memory

• Build a travel plan by saving destinations, itineraries, and preferences over multiple sessions.
• Track a research project with literature review, findings, and next steps.
• Manage a real estate search with criteria, listings, and visited properties.
• Develop an investment thesis by accumulating analysis and notes.
• Plan a product by storing requirements, feedback, and priorities.

FAQ from Structured Memory

What makes Structured Memory different from traditional MCP memory servers?

Traditional MCP memory servers use semantic search across scattered conversation snippets. Structured Memory instead maintains living documents with structured content that you can scan, update, and track over time, like a personal notebook with AI assistance.

Where are memory documents stored?

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

How do I create a new memory document?

Use the create_memory tool, or ask your LLM client to create one, for example: “Create a new travel advisor memory document and tell me how to use it.”

Does Structured Memory automatically backup documents?

Yes, the server automatically creates timestamped backups before every major update to a memory document.

What tools does Structured Memory provide?

The server provides ten tools: create_memory, list_memories, get_memory_summary, get_section, get_full_memory, search_within_memory, update_section, add_to_list, update_list_item, and move_list_item.